<html>
  <head>
	  <meta http-equiv="content-type" content="text/html; charset=utf-8" />
    <title>i5ting_ztree_toc:api3_1</title>
		<link href="toc/style/github-bf51422f4bb36427d391e4b75a1daa083c2d840e.css" media="all" rel="stylesheet" type="text/css"/>
		<link href="toc/style/github2-d731afd4f624c99a4b19ad69f3083cd6d02b81d5.css" media="all" rel="stylesheet" type="text/css"/>
		<link href="toc/css/zTreeStyle/zTreeStyle.css" media="all" rel="stylesheet" type="text/css"/>
	  <style>
		pre {
		    counter-reset: line-numbering;
		    border: solid 1px #d9d9d9;
		    border-radius: 0;
		    background: #fff;
		    padding: 0;
		    line-height: 23px;
		    margin-bottom: 30px;
		    white-space: pre;
		    overflow-x: auto;
		    word-break: inherit;
		    word-wrap: inherit;
		}

		pre a::before {
		  content: counter(line-numbering);
		  counter-increment: line-numbering;
		  padding-right: 1em; /* space after numbers */
		  width: 25px;
		  text-align: right;
		  opacity: 0.7;
		  display: inline-block;
		  color: #aaa;
		  background: #eee;
		  margin-right: 16px;
		  padding: 2px 10px;
		  font-size: 13px;
		  -webkit-touch-callout: none;
		  -webkit-user-select: none;
		  -khtml-user-select: none;
		  -moz-user-select: none;
		  -ms-user-select: none;
		  user-select: none;
		}

		pre a:first-of-type::before {
		  padding-top: 10px;
		}

		pre a:last-of-type::before {
		  padding-bottom: 10px;
		}

		pre a:only-of-type::before {
		  padding: 10px;
		}

		.highlight { background-color: #ffffcc } /* RIGHT */
		</style>
  </head>
  <body>
	  <div>
				<div style='width:25%;'>
						<ul id="tree" class="ztree" style='width:100%'>

						</ul>
				</div>
        <div id='readme' style='width:70%;margin-left:20%;'>
          	<article class='markdown-body'>
            	<h1 id="-">請求地址</h1>
<pre><code>`測試接口地址`：https://api.smerp.top/v3.1.1/api/接口名
`正式接口地址`：https://new.storages.top/v3.1.1/api/接口名
</code></pre><h1 id="-">登录相关</h1>
<h2 id="-">登录</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>登录</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/login</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>公共请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>登陆方式(0-&gt;验证码登录(主账号);1-&gt;密码登录(子账号);2-&gt;主账号密码登录)</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>device</td>
<td>是</td>
<td>否</td>
<td>当前登陆设备(1-安卓 2-ios 3-pc 4-微信小程序 5-抖音小程序)</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>mini_code</td>
<td>否</td>
<td>否</td>
<td>code(获取微信openid）</td>
<td>string</td>
<td>222222</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>type 0</code> 请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>mobile</td>
<td>是</td>
<td>否</td>
<td>手机号</td>
<td>string</td>
<td>1895555555</td>
</tr>
<tr>
<td>code</td>
<td>是</td>
<td>否</td>
<td>验证码</td>
<td>string</td>
<td>222222</td>
</tr>
<tr>
<td>bind_id</td>
<td>否</td>
<td>否</td>
<td>分享者id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>device_id</td>
<td>否</td>
<td>否</td>
<td>设备id</td>
<td>string</td>
<td>dvasdasv12edwd23</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>type 1</code> 请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>username</td>
<td>是</td>
<td>否</td>
<td>用户名</td>
<td>string</td>
<td>test</td>
</tr>
<tr>
<td>password</td>
<td>是</td>
<td>否</td>
<td>密码</td>
<td>string</td>
<td>123465</td>
</tr>
<tr>
<td>device_id</td>
<td>否</td>
<td>否</td>
<td>设备id</td>
<td>string</td>
<td>dvasdasv12edwd23</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>type 2</code> 请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>username</td>
<td>是</td>
<td>否</td>
<td>用户名</td>
<td>string</td>
<td>test</td>
</tr>
<tr>
<td>pwd</td>
<td>是</td>
<td>否</td>
<td>密码</td>
<td>string</td>
<td>123465</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
<pre><code>万能验证码为`666666`, 仅支持登录方式为主账号时使用，参数`device`正常传值即可
</code></pre></blockquote>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;user_id&quot;: 1,//用户id
        &quot;token&quot;: &quot;s1VuRi87NjmXmQViP6VQ8bl6rL3stOB10kI3D5UgUmFhm6XTBTrZIqC+vCGPZD9PC+dwQk+HtaegyKKqqGW5Xbd5ZtlVu5sZ66dLz4I84F2r/+1zIFWnXYSKkE+0RycXsFJ46Umq0iIIlX6bFDUyhC3CXzOlRp9iVBWiH/6Azzw=&quot;,//token
        &quot;parent_id&quot;:  1,//生成分享链接使用分享id
        &quot;is_main&quot;: 1; //账号类型;0:子;1:主;
        &quot;is_sync&quot;: 1; //是否同步;0:否;1:是;
         &quot;field_list&quot;: [//字段权限列表
            &quot;cost&quot;,
            &quot;selling_price&quot;
        ]
    }
}

</code></pre><h2 id="-">个人中心</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>个人中心</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/user_center</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 1216, //用户id
        &quot;username&quot;: &quot;15545436518&quot;,  //用户名(即登录使用账号)
        &quot;nickname&quot;: &quot;访客&quot;,   //用户昵称
        &quot;mobile&quot;: &quot;15545436518&quot;,    //手机号
        &quot;parent_id&quot;: 8, //父级id(主账号id)
        &quot;company_name&quot;: null,   //公司名称
        &quot;company_class&quot;: 0, //公司类型id
        &quot;is_active&quot;: 1, //是否启用;0:禁用;1:启用
        &quot;parent_id&quot;: 8,//生成分享链接所需要的分享者id标识
        &quot;bind_id&quot;: 1,//分享来源id
        &quot;is_default_pwd&quot;: 0,//是否有修改默认密码;0:否;1:是;(子账号登录时返回，主账号登录无此参数)
        &quot;invite_num&quot;: 0,//成功邀请次数
        &quot;name&quot;: null,   //公司类型名称
        &quot;is_main&quot;: 1, //账号类型;0:子;1:主;
        &quot;is_use_shelf&quot;: 1, //是否使貨架;0:否;1:是;
        &quot;is_bind_openid&quot;: 1,//是否有绑定微信或小程序:0:否;1:是;
        &quot;is_vip&quot;: 0,    //是否开通vip;0:否;1:是;2:VIP体验中;
        &quot;is_set_as_supplier&quot;:0,//是否将客户作为供应商使用;0:否;1:是;
        &quot;is_share_customer&quot;:0,//是否共享客户;0:否;1:是;
        &quot;account_storage&quot;: &quot;1.00&quot;,//可用存储空间(单位:M)
        &quot;file_total_size&quot;: &quot;0.09&quot;,//已用存储空间(单位:M)
        &quot;clear_watermark_or_not&quot;: 0,//去除水印，1是，0否
        &quot;is_in_experience&quot;:0,//是否开启体验;0:否;1:是;    
        &quot;is_end_experience&quot;:0,//体验是否到期;0:否;1:是;    
        &quot;is_share_express&quot;: 0,//是否共享快递信息;0:否;1:是;    
        &quot;is_first_charge&quot;: 0,//是否已经使用首次充值;0:否;1:是;
        &quot;is_use_serial&quot;: 0,//是否使用序列号;0:否;1:是;
        &quot;vip_end_date&quot;:0,//VIP到期时间
        &quot;wx_nickname&quot;: &quot;joker&quot;,//微信用户昵称
        &quot;invite_info&quot;: [
            &quot;18519122462&quot;,
            &quot;15505523456&quot;
        ],//通过分享邀请并成功注册的账号信息
        &quot;today_in_storage&quot;: 10000,  //今日入库数
        &quot;today_out_storage&quot;: 10000, //今日出库数
        &quot;today_package&quot;: 10000, //套餐数量
        &quot;today_trans_storage&quot;: 10000,    //调拨数量
        &quot;module_info&quot;: [
            {
                &quot;id&quot;: 1,//一级权限模块id
                &quot;module_name&quot;: &quot;系统设置&quot;,//一级权限模块名
                &quot;upper_module_id&quot;: 0,//上级权限模块id
                &quot;module_img&quot;: null,//权限模块图标
                &quot;type&quot;: &quot;&quot;,//类型
                &quot;sort&quot;: &quot;&quot;,//排序
                &quot;second_module&quot;: [
                    {
                        &quot;id&quot;: 2,//二权限模块id
                        &quot;module_name&quot;: &quot;模块管理&quot;,//二级权限模块名
                        &quot;upper_module_id&quot;: 1,//上级权限模块id
                        &quot;module_img&quot;: null,//权限模块图标
                        &quot;type&quot;: &quot;&quot;//类型
                        &quot;sort&quot;: &quot;&quot;,//排序
                    },
                    ......
                ]
            }
        ]
        &quot;field_list&quot;: []
    }
}
</code></pre><h1 id="-">商品管理</h1>
<h2 id="-">新建</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>编辑查询</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/materiel_type_add</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th style="text-align:left">示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>is_product_materiel</td>
<td>是</td>
<td>否</td>
<td>是否为套件;0:普通商品;1:套件;</td>
<td>integer</td>
<td style="text-align:left">0</td>
</tr>
<tr>
<td>materiel_name</td>
<td>是</td>
<td>否</td>
<td>物料名称或套件名称</td>
<td>sting</td>
<td style="text-align:left">保温箱</td>
</tr>
<tr>
<td>type_name</td>
<td>否</td>
<td>否</td>
<td>物料型号名称或套件型号名称</td>
<td>sting</td>
<td style="text-align:left">6L</td>
</tr>
<tr>
<td>materiel_img</td>
<td>否</td>
<td>是</td>
<td>物料类型图或套件图</td>
<td>sting</td>
<td style="text-align:left"><code>xxx.jpg</code> OR <code>xxx.png</code></td>
</tr>
<tr>
<td>materiel_no</td>
<td>否</td>
<td>是</td>
<td>套件编号</td>
<td>string</td>
<td style="text-align:left">7udIZcaQ</td>
</tr>
<tr>
<td>materiel_class_id</td>
<td>是</td>
<td>否</td>
<td>套件二级分类id</td>
<td>integer</td>
<td style="text-align:left">179</td>
</tr>
<tr>
<td>length</td>
<td>是</td>
<td>是</td>
<td>长(cm)</td>
<td>numeric</td>
<td style="text-align:left">19.1</td>
</tr>
<tr>
<td>width</td>
<td>否</td>
<td>是</td>
<td>宽(cm)</td>
<td>numeric</td>
<td style="text-align:left">0.1</td>
</tr>
<tr>
<td>height</td>
<td>否</td>
<td>是</td>
<td>高(cm)</td>
<td>numeric</td>
<td style="text-align:left">1.3</td>
</tr>
<tr>
<td>weight</td>
<td>否</td>
<td>是</td>
<td>重量(kg)</td>
<td>numeric</td>
<td style="text-align:left">3000</td>
</tr>
<tr>
<td>attribute</td>
<td>否</td>
<td>是</td>
<td>属性</td>
<td>string</td>
<td style="text-align:left">随便</td>
</tr>
<tr>
<td>cost</td>
<td>是</td>
<td>否</td>
<td>成本</td>
<td>numeric</td>
<td style="text-align:left">0.01</td>
</tr>
<tr>
<td>selling_price</td>
<td>否</td>
<td>是</td>
<td>销售价    销售价(默认为0）</td>
<td>numeric</td>
<td style="text-align:left">10000</td>
</tr>
<tr>
<td>lower_selling_price</td>
<td>否</td>
<td>是</td>
<td>最低销售价格</td>
<td>numeric</td>
<td style="text-align:left">10000</td>
</tr>
<tr>
<td>materiel_unit</td>
<td>否</td>
<td>是</td>
<td>商品或套件单位</td>
<td>string</td>
<td style="text-align:left">件</td>
</tr>
<tr>
<td>is_album</td>
<td>是</td>
<td>否</td>
<td>是否在画册中展示(默认为0);0:否;1:是;</td>
<td>integer</td>
<td style="text-align:left">0</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>是</td>
<td>备注</td>
<td>string</td>
<td style="text-align:left">这是备注</td>
</tr>
<tr>
<td>is_use_serial</td>
<td>是</td>
<td>否</td>
<td>是否开启序列号;0:否;1:是;</td>
<td>integer</td>
<td style="text-align:left">0</td>
</tr>
<tr>
<td>product_content</td>
<td>否</td>
<td>否</td>
<td>套件内容(添加商品为套件时必填)</td>
<td>json_array</td>
<td style="text-align:left"><code>[{&quot;type_id&quot;:39790,&quot;unit_price&quot;:1000.011,&quot;num&quot;:1}</code>]</td>
</tr>
<tr>
<td>price_type</td>
<td>是</td>
<td>否</td>
<td>计算方式：0:套件商品总金额;1:套餐金额</td>
<td>integer</td>
<td style="text-align:left">0</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数<code>product_content</code></p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>type_id</td>
<td>是</td>
<td>是</td>
<td>商品id</td>
<td>string</td>
<td>商品id</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>是</td>
<td>商品id</td>
<td>integer</td>
<td>111</td>
</tr>
<tr>
<td>selling_price</td>
<td>是</td>
<td>是</td>
<td>商品销售价格(数据来源：商品信息)</td>
<td>float</td>
<td>2222.022</td>
</tr>
<tr>
<td>price</td>
<td>是</td>
<td>是</td>
<td>金额</td>
<td>float</td>
<td>2222.022</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注（同修改物料商品接口）</p>
<pre><code>1.套件内商品金额默认以商品信息中心的商品销售价格填充,且允许修改;
2.当套件金额`selling_price`与套件内商品的总价不符时，需让用户自行选择计算方式(`price_type`)；
    -`price_type`为1时，使用套件金额对套件内商品金额进行调整;
        a.套件金额大于套件内商品累计金额时，获得涨价比例(计算方式:（套件金额 - 套件内商品累计金额） / 套件内商品累计金额)，
          套件内单个商品金额根据涨价比例重新计算(计算方式:(涨价比例 * 套件内单个商品金额) + 套件内单个商品金额)
        b.套件金额小于套件内商品累计金额时，获得折扣比(计算方式：套件金额 / 套件内商品累计金额)，套件内单个商品金额根据
          折扣比重新计算(计算方式：折扣比 * 套件内单个商品金额)
    -`price_type`为0时，以套件内所有商品累计金额作为套件金额; 
</code></pre></blockquote>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 5032 //新增物料id
    }
}
</code></pre><h2 id="-">物料类型下拉列表(孙武)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>物料类型下拉列表</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/materiel_type_select</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>每页条数</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>当前页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>materiel_calss_id</td>
<td>否</td>
<td>否</td>
<td>二级分类id，默认为0</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>关键词</td>
<td>string</td>
<td>面膜</td>
</tr>
<tr>
<td>is_product_materiel</td>
<td>否</td>
<td>否</td>
<td>是否为套餐;0:否;1:是;</td>
<td>string</td>
<td>面膜</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,//当前页
        &quot;data&quot;: [
            {
                &quot;id&quot;: 558,  //物料商品id
                &quot;materiel_name&quot;: &quot;艾纯烟酰胺亮肤补水修护套盒&quot;,   //物料名
                &quot;type_name&quot;: &quot;10件套&quot;,    //型号
                &quot;materiel_img&quot;: null,   //物料商品图
                &quot;materiel_no&quot;: &quot;&quot;,  //物料编号
                &quot;materiel_class_id&quot;: 9, //物料商品二级分类id
                &quot;sec_class_name&quot;: &quot;护肤品套装&quot;,  //物料商品二级分类名
                &quot;fir_class_id&quot;: 3,  //物料商品一级分类id
                &quot;fir_class_name&quot;: &quot;美妆用品&quot;,    //物料商品一级分类名
                &quot;remark&quot;: &quot;美妆用品&quot;    //商品备注
                &quot;length&quot;: &quot;0.00&quot;, //长度
                &quot;width&quot;: &quot;0.00&quot;,//宽度
                &quot;height&quot;: &quot;0.00&quot;,//高度
                &quot;weight&quot;: &quot;0.00&quot;,//重量
                &quot;attribute&quot;: &quot;&quot;,//属性
                &quot;cost&quot;: &quot;0.00&quot;,//成本
                &quot;selling_price&quot;:0.22,//售价
                &quot;is_use_serial&quot;:0,//是否开启序列号;0:否;1:是;
                &quot;lower_selling_price&quot;:0.22,//最低售价
                &quot;is_product_materiel&quot;: 0, //是否为套餐;0:否;1:是;
            }
        ],
        ......
        &quot;total&quot;: 1//总数
    }
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-09-07 16:06`:增加请求参数`selling_price`、`is_use_serial`
`2022-12-21 16:05`:增加请求参数`lower_selling_price`
</code></pre></blockquote>
<h2 id="-">物料类型列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>物料类型列表</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/materiel_type_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>页面大小</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>当前页</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>materiel_class_id</td>
<td>否</td>
<td>是</td>
<td>物料所属二级分类id</td>
<td>integer</td>
<td>107</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>是</td>
<td>关键词(支持<code>物料名</code>,<code>物料型号</code>,<code>物料编号</code>)</td>
<td>string</td>
<td>电子体温计</td>
</tr>
<tr>
<td>type_id</td>
<td>否</td>
<td>是</td>
<td>商品id(多商品id默认以英文逗号拼接)</td>
<td>string</td>
<td>107,104</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,//当前页
        &quot;data&quot;: [
            {
                &quot;id&quot;: 5590,//物料id
                &quot;materiel_name&quot;: &quot;小扑电池里用的&quot;,//物料名
                &quot;type_name&quot;: &quot;电池&quot;,//物料型号
                &quot;materiel_class_id&quot;: 107,//物料所属二级分类id
                &quot;length&quot;: &quot;0.00&quot;, //长度
                &quot;width&quot;: &quot;0.00&quot;,//宽度
                &quot;height&quot;: &quot;0.00&quot;,//高度
                &quot;weight&quot;: &quot;0.00&quot;,//重量
                &quot;attribute&quot;: &quot;&quot;,//属性
                &quot;cost&quot;: &quot;0.00&quot;,//成本
                &quot;main_id&quot;: 7,
                &quot;remark&quot;: null,
                &quot;delete_flag&quot;: 0,
                &quot;created_at&quot;: null,
                &quot;updated_at&quot;: null,
                &quot;materiel_img&quot;: null,//物料图
                &quot;materiel_no&quot;: &quot;&quot;,//物料编号
                &quot;s_class_id&quot;: 122,//二级分类id
                &quot;s_class_name&quot;: &quot;辅助工具&quot;,//二级分类名称
                &quot;s_class_no&quot;: &quot;&quot;,//二级分类编号
                &quot;f_class_name&quot;: &quot;工作箱&quot;,//一级分类名称
                &quot;f_class_no&quot;: &quot;&quot;,//一级分类编号
                &quot;f_class_id&quot;: 67//二级分类编号
                &quot;storage_manage_id&quot;: 111,//库存id
                &quot;in_storage_num&quot;: 67,//物料在库数量,无数量时显示为`null`
                &quot;storage_id&quot;: 3,//仓库id
                &quot;storage_name&quot;: &quot;蚌埠掌上网络科技有限公司&quot;//仓库名称
                &quot;shelf_id&quot;: 1613, //货架ID
                &quot;location_id&quot;: 1614,//库位ID
                &quot;shelf_name&quot;: &quot;测试货架1&quot;, //货架名称
                &quot;location_name&quot;: &quot;测试库位2&quot; //库位名称
                &quot;is_use_serial&quot;:0,//是否开启序列号;0:否;1:是;
                &quot;is_product_materiel&quot;: 1,//是否为套件
                &quot;product_use_tag&quot;: 1,//套餐使用标记;0:否;1:是;
            }
        ],
        &quot;total&quot;: &quot;10&quot;,//总条数
    }
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-09-07 15:55`:增加请求参数`is_use_serial`
`2022-08-25 16:40`:增加`shelf_id`,`location_id`,`shelf_name`,`location_name`返回 
`2022-11-23 14:48`:增加`is_product_materiel`、`product_use_tag`返回 
</code></pre></blockquote>
<h2 id="-">修改物料商品(孙武)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>修改物料商品</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/materiel_type_edit</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>物料商品id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>materiel_name</td>
<td>是</td>
<td>否</td>
<td>物料名称</td>
<td>sting</td>
<td>保温箱</td>
</tr>
<tr>
<td>type_name</td>
<td>否</td>
<td>否</td>
<td>物料型号名称</td>
<td>sting</td>
<td>6L</td>
</tr>
<tr>
<td>materiel_img</td>
<td>否</td>
<td>是</td>
<td>物料类型图</td>
<td>sting</td>
<td><code>xxx.jpg</code> OR <code>xxx.png</code></td>
</tr>
<tr>
<td>materiel_no</td>
<td>否</td>
<td>是</td>
<td>物料编号</td>
<td>string</td>
<td>7udIZcaQ</td>
</tr>
<tr>
<td>materiel_class_id</td>
<td>是</td>
<td>否</td>
<td>物料二级分类id</td>
<td>integer</td>
<td>179</td>
</tr>
<tr>
<td>length</td>
<td>是</td>
<td>是</td>
<td>长(cm</td>
<td>numeric</td>
<td>19.1</td>
</tr>
<tr>
<td>width</td>
<td>否</td>
<td>是</td>
<td>宽(cm)</td>
<td>numeric</td>
<td>0.1</td>
</tr>
<tr>
<td>height</td>
<td>否</td>
<td>是</td>
<td>高(cm)</td>
<td>numeric</td>
<td>1.3</td>
</tr>
<tr>
<td>weight</td>
<td>否</td>
<td>是</td>
<td>重量(kg)</td>
<td>numeric</td>
<td>3000</td>
</tr>
<tr>
<td>attribute</td>
<td>否</td>
<td>是</td>
<td>属性</td>
<td>string</td>
<td>随便</td>
</tr>
<tr>
<td>cost</td>
<td>是</td>
<td>否</td>
<td>成本</td>
<td>numeric</td>
<td>0.01</td>
</tr>
<tr>
<td>selling_price</td>
<td>否</td>
<td>是</td>
<td>销售价(默认为0）</td>
<td>numeric</td>
<td>10000</td>
</tr>
<tr>
<td>lower_selling_price</td>
<td>否</td>
<td>是</td>
<td>最低销售价格</td>
<td>numeric</td>
<td>10000</td>
</tr>
<tr>
<td>materiel_unit</td>
<td>否</td>
<td>是</td>
<td>商品单位</td>
<td>string</td>
<td>件</td>
</tr>
<tr>
<td>is_album</td>
<td>是</td>
<td>否</td>
<td>是否在画册中展示(默认为0);0:否;1:是;</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>是</td>
<td>备注</td>
<td>string</td>
<td>这是备注</td>
</tr>
<tr>
<td>is_use_serial</td>
<td>是</td>
<td>否</td>
<td>是否开启序列号;0:否;1:是;</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>is_product_materiel</td>
<td>是</td>
<td>否</td>
<td>是否为套件;0:普通商品;1:套件;</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>product_content</td>
<td>否</td>
<td>否</td>
<td>套件内容(添加商品为套件时必填)</td>
<td>json_array</td>
<td><code>[{&quot;type_id&quot;:39790,&quot;unit_price&quot;:1000.011,&quot;num&quot;:1}</code>]</td>
</tr>
<tr>
<td>price_type</td>
<td>是</td>
<td>否</td>
<td>计算方式：0:套件商品总金额;1:套件金额</td>
<td>integer</td>
<td>0</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数<code>product_content</code></p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>type_id</td>
<td>是</td>
<td>是</td>
<td>商品id</td>
<td>string</td>
<td>商品id</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>是</td>
<td>商品id</td>
<td>integer</td>
<td>111</td>
</tr>
<tr>
<td>selling_price</td>
<td>是</td>
<td>是</td>
<td>商品销售价格(数据来源：商品信息)</td>
<td>float</td>
<td>2222.022</td>
</tr>
<tr>
<td>price</td>
<td>是</td>
<td>是</td>
<td>金额</td>
<td>float</td>
<td>2222.022</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-09-07 15:43`:增加请求参数`is_use_serial`
`2022-08-05 20:13`:增加请求参数`lower_selling_price`,`is_album`,`materiel_unit`(与接口`materiel_type_edit`增加的请求参数相同)
`2022-11-08 14:29`:增加请求参数`is_product_materiel`、`product_content`
</code></pre><h2 id="-sw-">指定物料类型详细信息(Sw)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>编辑查询</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/materiel_type_info</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>物料类型id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 1,//物料类型id
        &quot;materiel_name&quot;: &quot;400ML注水冰盒&quot;,//物料类型名称
        &quot;type_name&quot;: &quot;400ML&quot;,//物料型号
        &quot;materiel_img&quot;: null,//物料图
        &quot;materiel_no&quot;: &quot;&quot;,//物料编号
        &quot;materiel_class_id&quot;: 71,//物料分类二级id
        &quot;remark&quot;: null,//物料备注
        &quot;length&quot;: &quot;0.00&quot;, //长度
        &quot;width&quot;: &quot;0.00&quot;,//宽度
        &quot;height&quot;: &quot;0.00&quot;,//高度
        &quot;weight&quot;: &quot;0.00&quot;,//重量
        &quot;attribute&quot;: &quot;&quot;,//属性
        &quot;cost&quot;: &quot;0.00&quot;,//成本
        &quot;sec_class_name&quot;: &quot;冷源&quot;,//物料二级分类名称
        &quot;fir_class_id&quot;: 56,//物料一级分类id
        &quot;fir_class_name&quot;: &quot;保温箱类&quot;//物料一级分类名称
        &quot;selling_price&quot;:0//销售价格
        &quot;lower_selling_price&quot;:0//最低销售价格
        &quot;is_album&quot;:0,//是否在画册中展示;0:否;1:是;
        &quot;materiel_unit&quot;: &quot;件&quot;,//单位
        &quot;is_use_serial&quot;: 0,//是否开启序列号;0:否;1:是;
        &quot;is_product_materiel&quot;: 1,//是否为套件
        &quot;product_use_tag&quot;: 1,//套餐使用标记;0:否;1:是;
        &quot;content&quot;: [
            {
                &quot;id&quot;: 1,    //套件内容id
                &quot;materiel_name&quot;: &quot;400ML注水冰盒&quot;,   //套件内商品名
                &quot;type_name&quot;: &quot;400ML&quot;,   //套件内商品规格
                &quot;materiel_img&quot;: &quot;&quot;, //套件内商品图
                &quot;materiel_no&quot;: &quot;&quot;,  //套件内商品编号
                &quot;product_id&quot;: 49715,    //套件id(所属套件id)
                &quot;num&quot;: &quot;1.000000&quot;,  //数量
                &quot;price&quot;: &quot;10.350000&quot;,   //套件内商品金额
                &quot;total_price&quot;: &quot;10.350000&quot;  //套件内商品总金额(套件内商品金额 * 数量)
            },
        ]
    }
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-09-07 15:55`:增加请求参数`is_use_serial`
`2022-08-05 20:13`:增加请求参数`lower_selling_price`,`is_album`,`materiel_unit`,`selling_price`(与接口`materiel_type_edit`增加的请求参数相同)
`2022-11-12 18:26`:增加请求参数`is_product_materiel`和`content`
`2022-11-23 14:48`:增加`product_use_tag`返回 
</code></pre><h2 id="-sw-">套件信息(Sw)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>编辑查询</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/materiel_package_info</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>物料类型id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>sell_id</td>
<td>否</td>
<td>否</td>
<td>销售单id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
</blockquote>
<pre><code>`sell_id`仅供销售单查看套件内容时为必传
</code></pre><blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: [
        {
            &quot;id&quot;: 29,   //套件id
            &quot;type_id&quot;: 348, //套件商品id
            &quot;price&quot;: &quot;16.000000&quot;,   //单价
            &quot;total_price&quot;: &quot;160.000000&quot;,    //  总价(单价*数量)    
            &quot;origin_price&quot;: &quot;16.000000&quot;,   //原价(新建时填写的价格)
            &quot;product_id&quot;: 52029,    //套餐id
            &quot;num&quot;: &quot;10.000000&quot;, //  数量
            &quot;main_id&quot;: 7,
            &quot;delete_flag&quot;: 0, 
            &quot;created_at&quot;: &quot;2022-11-29 14:02:55&quot;,
            &quot;updated_at&quot;: &quot;2022-11-29 14:02:56&quot;,
            &quot;materiel_name&quot;: &quot;冰盒400ml&quot;, //  套件商品名
            &quot;type_name&quot;: &quot;400ml&quot;,   //  套件规格名
            &quot;materiel_unit&quot;: &quot;&quot;, //  套件商品单位
            &quot;materiel_img&quot;: &quot;&quot;//套件商品图
        }
        ......
    ]
}
</code></pre><h1 id="-">生产订单 - 所有批次号相关的传参全部取消</h1>
<h2 id="-">新建</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>新建</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/product_add</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>task_content</td>
<td>否</td>
<td>否</td>
<td>生产任务</td>
<td>string</td>
<td>[{&quot;type_id&quot;:49715,&quot;is_product_materiel&quot;:1,&quot;num&quot;:2}]</td>
</tr>
<tr>
<td>materiel_content</td>
<td>是</td>
<td>否</td>
<td>生产原料</td>
<td>string</td>
<td>[{&quot;type_id&quot;:51226,&quot;num&quot;:2,&quot;storage_manage_info&quot;:[{&quot;storage_manage_id&quot;:46331,&quot;num&quot;:1}],&quot;serial_info&quot;:[]}]</td>
</tr>
<tr>
<td>product_way</td>
<td>否</td>
<td>否</td>
<td>生产方式;0:原料加工;1:套餐组合;</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>product_source</td>
<td>否</td>
<td>否</td>
<td>订单来源;0:普通生产订单;1:销售单;</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>product_source_id</td>
<td>否</td>
<td>否</td>
<td>订单来源id</td>
<td>integer</td>
<td>179</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数 <code>task_content</code></p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>type_id</td>
<td>是</td>
<td>否</td>
<td>商品</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>is_product_materiel</td>
<td>是</td>
<td>否</td>
<td>是否为套餐</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>任务数量</td>
<td>integer</td>
<td>0</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数 <code>materiel_content</code></p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>storage_manage_info</td>
<td>否</td>
<td>否</td>
<td>商品库信息(默认为空数组)</td>
<td>string</td>
<td>[{&quot;storage_manage_id&quot;:46331,&quot;num&quot;:1}]</td>
</tr>
<tr>
<td>serial_info</td>
<td>是</td>
<td>否</td>
<td>库存序列号信息(默认为空数组)</td>
<td>string</td>
<td>[{&quot;storage_manage_id&quot;:46330,&quot;num&quot;:2, &quot;serial_id&quot;:1}]</td>
</tr>
<tr>
<td>type_id</td>
<td>是</td>
<td>否</td>
<td>生产原料id(商品或套件id)</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>生产原料数量</td>
<td>integer</td>
<td>0</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数 <code>storage_manage_info</code></p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>storage_manage_id</td>
<td>是</td>
<td>批次号对应库存id</td>
<td>生产原料id(商品或套件id)</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>批次数量</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数 <code>serial_info</code></p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>serial_id</td>
<td>是</td>
<td>否</td>
<td>序列号id</td>
<td>integer</td>
<td>211</td>
</tr>
<tr>
<td>storage_manage_id</td>
<td>是</td>
<td>序列号对应库存id</td>
<td>生产原料id(商品或套件id)</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>序列号数量</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
</blockquote>
<pre><code>当订单来源为销售单时，`task_content`为空，生产任务由后台从销售单中进行获取；
当订单来源为普通生产订单时,`task_content`为必填;
当商品开启序列号以后，`storage_manage_info`为空数组`[]`;未开启序列号时，`serial_info`为空数组`[]`;
</code></pre><blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: 1 //新增id
}
</code></pre><h2 id="-">订单生产完成</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>重新下单</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/product_finished</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>生产订单id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>product_info</td>
<td>是</td>
<td>否</td>
<td>生产任务信息</td>
<td>json</td>
<td>[{&quot;id&quot;:11,&quot;num&quot;:&quot;1&quot;},{&quot;id&quot;:10,&quot;num&quot;:&quot;2&quot;}]</td>
</tr>
<tr>
<td>product_time</td>
<td>是</td>
<td>否</td>
<td>生产时间(仅支持例：2008-08-08 08:08:08)</td>
<td>date</td>
<td>2008-08-08 08:08:08</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>生产任务信息</code> 参数说明</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>生产任务主键id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>生产数量</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">重新下单</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>重新下单</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/product_add_again</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>生产订单id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注 
<code>非普通生产订单无法重新下单</code></p>
</blockquote>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">详细</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>详细</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/product_detail(<code>无token:v3.1.1/api/product_detail_common</code>,<code>请求方式为get</code>)</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>生产订单的id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
<pre><code>`storage_handle_num`:当生产订单内选定的库存商品是序列号相关时，当返回为非0时，还库列表中不应再显示此条信息对应的序列号
</code></pre></blockquote>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 1,    //主键id
        &quot;product_no&quot;: &quot;p20230104113052239897595&quot;,   //生产订单编号
        &quot;product_status&quot;: 2,    //生产订单状态;0:未开始;1:进行中;2:已完成;    
        &quot;product_source&quot;: 0,    //订单来源;0:普通生产订单;1:销售单;
        &quot;product_source_id&quot;: 0, //订单来源id
        &quot;total_num&quot;: &quot;4.000000&quot;,    //生产任务总数
        &quot;finished_num&quot;: &quot;4.000000&quot;, //已完成任务数
        &quot;relation_no&quot;: &quot;&quot;,  //关联单号
        &quot;product_way&quot;: 1,   //生产方式;0:原料加工;1:套餐组合;
        &quot;in_storage_type&quot;: 0,   //入库方式;0:无;1:入库;2:套件返仓;    
        &quot;storage_operate_status&quot;: 0,    //库存操作状态;0:未开始;1:进行中;2:已完成;    
        &quot;is_cancel&quot;: 0, //是否撤销;0:否;1:是;
        &quot;user_id&quot;: 11118,
        &quot;main_id&quot;: 11118,
        &quot;delete_flag&quot;: 0,
        &quot;created_at&quot;: &quot;2023-01-04 11:30:52&quot;,
        &quot;updated_at&quot;: &quot;2023-01-04 14:10:55&quot;,
        //生产原料信息
        &quot;slave_content&quot;: [
            {
                &quot;id&quot;: 1,
                &quot;type_id&quot;: 348, //商品id
                &quot;rest_balance_num&quot;: 899,
                &quot;num&quot;: &quot;22.000000&quot;, //可操作数量
                &quot;storage_operate_num&quot;: &quot;0.000000&quot;,  //已操作数量
                &quot;type_name&quot;: &quot;400ml&quot;,   //商品名
                &quot;materiel_name&quot;: &quot;冰盒400ml&quot;, //规格名
                &quot;materiel_unit&quot;: &quot;&quot;,    //商品单位
                &quot;is_use_serial&quot;: 0, //是否开启序列号
                //选取的生产原料商品库存信息
                &quot;slave_content_storage_info&quot;: [
                    {
                        &quot;storage_name&quot;: &quot;37栋4层-2&quot;,  //仓库名
                        &quot;storage_address&quot;: &quot;37栋4层-2&quot;,   //仓库地址
                        &quot;shelf_name&quot;: &quot;默认货架&quot;,   //货架名
                        &quot;location_name&quot;: &quot;默认库位&quot;,    //库位名
                        &quot;serial_no&quot;: &quot;1&quot;    //序列号
                        &quot;serial_id&quot;: 0, //序列号id
                        &quot;storage_manage_id&quot;: 1745, //库存id
                        &quot;num&quot;: &quot;40.000000&quot;, //可操作数量
                        &quot;storage_operate_num&quot;: &quot;0.000000&quot;,  //已操作数量
                        &quot;storage_handle_num&quot;: &quot;0.000000&quot;,   //生产订单内选定的库存商品已还库数量
                        &quot;rest_num&quot;: 40  //剩余可操作数量
                    }
                ],

            }
        ],
        &quot;fill_balance_info&quot;: [
            {
                &quot;type_id&quot;: 73840,//商品id
                 &quot;is_use_serial&quot;: 1,
                &quot;materiel_name&quot;: &quot;serial_goods&quot;,//商品名称
                &quot;type&quot;: 0,//类型;0:补足;1:还库; 
                &quot;storage_manage_info&quot;: [
                    {
                        &quot;serial_id&quot;: 710,//序列号id
                        &quot;serial_no&quot;: &quot;1&quot;,//序列号
                        &quot;num&quot;: &quot;1.000000&quot;,//数量 
                        &quot;storage_name&quot;: &quot;仓库2&quot;//仓库
                          &quot;shelf_name&quot;: &quot;默认货架&quot;,
                        &quot;location_name&quot;: &quot;默认库位&quot;
                    },
                   ......
                ]
            }
        ],
        &quot;slave_info&quot;: [
            {
                &quot;id&quot;: 1, //生产订单子单id
                &quot;num&quot;: &quot;12.000000&quot;, //生产任务数
                &quot;finished_num&quot;: &quot;10.000000&quot;//已完成数量
                &quot;is_product_materiel&quot;: 1,   //是否为套餐;0:否;1:是;
                &quot;type_name&quot;: &quot;1&quot;,   //规格名
                &quot;materiel_name&quot;: &quot;12311&quot;,   //商品名
                &quot;product_order_id&quot;: 1,
                &quot;type_id&quot;: 29054,   //商品id
                &quot;materiel_img&quot;: &quot;&quot;, //商品图
                &quot;materiel_unit&quot;: &quot;&quot;,    //商品单位
                &quot;materiel_no&quot;: &quot;yORdyRC8&quot;,  //商品编号
                &quot;selling_price&quot;: &quot;1.000000&quot; //商品售价
                &quot;is_use_serial&quot;: 0, //是否开启序列号;0:否;1:是;
                &quot;storage_operate_num&quot;: &quot;0.000000&quot;   //出入库操作数量
                &quot;in_storage_num&quot;:&quot;1.000000&quot;//当前库存数
            }
            ......
        ]
    }
}
</code></pre><h2 id="-">删除</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>删除</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/product_del</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>生产订单id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>列表</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/product_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>条数</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>status</td>
<td>是</td>
<td>否</td>
<td>生产订单状态;0:全部;1:未完成;2:生产中;3:已完成;</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>search_type</td>
<td>是</td>
<td>否</td>
<td>搜索类型(默认为0);0:无;1:商品名;2:规格名;3:商品编号;4:内部单号;5:关联单号;6:操作人;</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>关键词</td>
<td>string</td>
<td>1</td>
</tr>
<tr>
<td>start_time</td>
<td>否</td>
<td>否</td>
<td>开始时间</td>
<td>date</td>
<td>2022-12-24</td>
</tr>
<tr>
<td>end_time</td>
<td>否</td>
<td>否</td>
<td>结束时间</td>
<td>date</td>
<td>2022-12-24</td>
</tr>
<tr>
<td>repeal_status</td>
<td>是</td>
<td>否</td>
<td>是否撤销;0:否;1:是;</td>
<td>integer</td>
<td>0</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
            {
                &quot;id&quot;: 4,
                &quot;product_no&quot;: &quot;p20221123172104173835380&quot;,   //生产订单编号
                &quot;product_status&quot;: 0,    //生产订单状态;0:未完成;1:生产中;2:已完成;    
                &quot;product_source&quot;: 0,    //订单来源;0:普通生产订单;1:销售单;
                &quot;product_source_id&quot;: 0, //订单来源id    
                &quot;total_num&quot;: 17,    //生产任务总数
                &quot;finished_num&quot;: 0,  //已完成任务数    
                &quot;relation_no&quot;: &quot;&quot;,  //关联单号    
                &quot;product_way&quot;: 1,   //生产方式;0:原料加工;1:套餐组合;    
                &quot;is_cancel&quot;:0,  //是否撤销;0:否;1:是;
                &quot;nickname&quot;: &quot;弘牧科技&quot;, //操作人
                //生产任务信息
                &quot;slave_info&quot;: [
                    {
                        &quot;id&quot;: 8,
                        &quot;num&quot;: &quot;2.000000&quot;,  //数量
                        &quot;is_product_materiel&quot;: 1,   //是否为套餐;0:否;1:是;
                        &quot;type_name&quot;: &quot;快拧外丝&quot;,    //套餐名或商品名(任务名)
                        &quot;materiel_name&quot;: &quot;H0001&quot;,   //规格名
                        &quot;product_order_id&quot;: 4,
                        &quot;materiel_unit&quot;:&quot;&quot;//商品单位
                    },
                    ......
                ],
                //生产原料信息
                &quot;slave_content&quot;: [
                    {
                        &quot;id&quot;: 15,
                        &quot;product_order_id&quot;: 4,
                        &quot;type_name&quot;: &quot;400ML&quot;,   //商品规格
                        &quot;materiel_name&quot;: &quot;400ML注水冰盒&quot;,   //商品名
                    },
                    ......
                ],
                //生产原料对应的所有库存信息
                &quot;slave_content_storage&quot;: [
                    {
                        &quot;id&quot;: 7,
                        &quot;product_order_id&quot;: 6,
                        &quot;type_name&quot;: &quot;400ML&quot;,   //商品规格
                        &quot;materiel_name&quot;: &quot;400ML注水冰盒&quot;,   //商品名
                        &quot;storage_name&quot;: &quot;37栋3层-1&quot;,  //仓库名
                        &quot;storage_address&quot;: &quot;37栋3层-1&quot;,   //仓库地址
                        &quot;shelf_name&quot;: &quot;默认货架&quot;,   //货架名
                        &quot;location_name&quot;: &quot;默认库位&quot;,    //库位名
                        &quot;serial_no&quot;: null   //序列号
                    }
                ]
            }
        ],
        ......
        &quot;total&quot;: 1
    }
}
</code></pre><h2 id="-">撤销</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>撤销</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/product_cancel</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>生产订单id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
</blockquote>
<pre><code>当前版本，仅生产订单状态为未完成状态下可撤销
</code></pre><blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">补足或还库</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>补足或还库</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/product_fill_or_balance</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>生产订单id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>操作类型;0:补足;1:还库;</td>
<td>integer</td>
<td>1</td>
<td></td>
</tr>
<tr>
<td>materiel_content</td>
<td>是</td>
<td>是</td>
<td>生产任务信息</td>
<td>date</td>
<td>[{&quot;type_id&quot;:51226,&quot;num&quot;:2,&quot;storage_manage_info&quot;:[{&quot;storage_manage_id&quot;:46331,&quot;num&quot;:1}],&quot;serial_info&quot;:[]}]</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数 <code>materiel_content</code></p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>storage_manage_info</td>
<td>否</td>
<td>否</td>
<td>商品库信息(默认为空数组)</td>
<td>string</td>
<td>[{&quot;storage_manage_id&quot;:46331,&quot;num&quot;:1}]</td>
</tr>
<tr>
<td>serial_info</td>
<td>是</td>
<td>否</td>
<td>库存序列号信息(默认为空数组)</td>
<td>string</td>
<td>[{&quot;storage_manage_id&quot;:46330,&quot;num&quot;:2, &quot;serial_id&quot;:1}]</td>
</tr>
<tr>
<td>type_id</td>
<td>是</td>
<td>否</td>
<td>生产原料id(商品或套件id)</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>生产原料数量</td>
<td>integer</td>
<td>0</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数 <code>storage_manage_info</code></p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>storage_manage_id</td>
<td>是</td>
<td>批次号对应库存id</td>
<td>生产原料id(商品或套件id)</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>批次数量</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数 <code>serial_info</code></p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>serial_id</td>
<td>是</td>
<td>否</td>
<td>序列号id</td>
<td>integer</td>
<td>211</td>
</tr>
<tr>
<td>storage_manage_id</td>
<td>是</td>
<td>序列号对应库存id</td>
<td>生产原料id(商品或套件id)</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>序列号数量</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
</blockquote>
<pre><code>1.当前版本，当生产订单处于已完成状态时，才可进行补足或还库
2.当`serial_info`不为空时，将以请求参数`materiel_content`中的`serial_info`部分作为实际使用的请求参数，`materiel_content`中
的`num`用于验证序列号数量是否与该`num`所需数量是否一致
</code></pre><blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-1-10 10:51`:删除请求参数`tast_content`相关请求
</code></pre><h2 id="-">出入库或套件返仓</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>出入库或套件返仓</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/product_in_or_out</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>生产订单id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>操作类型;1:入库;2:套件返仓;3:出库;</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>storage_id</td>
<td>是</td>
<td>否</td>
<td>仓库id;<code>type</code>为0时必传</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>shelf_id</td>
<td>否</td>
<td>否</td>
<td>货架id;<code>type</code>为0时必传</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>location_id</td>
<td>否</td>
<td>否</td>
<td>库位id;<code>type</code>为0时必传</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>task_content</td>
<td>否</td>
<td>否</td>
<td>生产任务内容;<code>type</code>为1或3时必传,非0时忽略</td>
<td>json</td>
<td>[{&quot;id&quot;:11,&quot;type_id&quot;:256,&quot;num&quot;:1,&quot;serial_info&quot;:&quot;&quot;}]</td>
</tr>
<tr>
<td>materiel_content</td>
<td>是</td>
<td>否</td>
<td>生产原料;<code>type</code>不为0时必传,为0时忽略;(废弃)</td>
<td>string</td>
<td>[{&quot;type_id&quot;:51226,&quot;num&quot;:2,&quot;storage_manage_info&quot;:[{&quot;storage_manage_id&quot;:46331,&quot;num&quot;:1}],&quot;serial_info&quot;:[]}]</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>task_content</code>参数内容</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>生产任务id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>type_id</td>
<td>是</td>
<td>否</td>
<td>商品id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>serial_info</td>
<td>是</td>
<td>否</td>
<td>序列号;多序列号以<code>,</code>拼接</td>
<td>string</td>
<td><code>123,456</code></td>
</tr>
<tr>
<td>is_product_materiel</td>
<td>否</td>
<td>否</td>
<td>是否为套(整件入库时必传,其他情况忽略);0:否;1:是;</td>
<td>string</td>
<td>这是备注</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>这是备注</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>materiel_content</code>参数内容</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>type_id</td>
<td>是</td>
<td>否</td>
<td>商品id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>storage_manage_info</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>json</td>
<td>1</td>
</tr>
<tr>
<td>serial_info</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>json</td>
<td>1</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>这是备注</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数 <code>storage_manage_info</code></p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>storage_manage_id</td>
<td>是</td>
<td>批次号对应库存id</td>
<td>生产原料id(商品或套件id)</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>批次数量</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数 <code>serial_info</code></p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>serial_id</td>
<td>是</td>
<td>否</td>
<td>序列号id</td>
<td>integer</td>
<td>211</td>
</tr>
<tr>
<td>storage_manage_id</td>
<td>是</td>
<td>序列号对应库存id</td>
<td>生产原料id(商品或套件id)</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>序列号数量</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>type</code>说明</p>
<pre><code>当`type`为0时，入库方式基于生产任务进行整库入库，入库时需选择仓库进行所有生产任务的整体入库;
当`type`为1时，入库方式基于生产原料进行入库,入库时无需选择仓库，按生产原料来源库存信息进行入库;
当`type`为2时，仅销售单生成的生产订单可以进行出库，出库方式基于设定好的生产原料进行出库;
</code></pre></blockquote>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">入库或套件返仓序列号选择</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>出入库或套件返仓</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/product_serial_select</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>type_id</td>
<td>是</td>
<td>否</td>
<td>套餐id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>关键词</td>
<td>sting</td>
<td>保温箱</td>
</tr>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>生产订单id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
<pre><code>{
  &quot;code&quot;: 0,
  &quot;msg&quot;: &quot;success&quot;,
  &quot;data&quot;: [
    {
      &quot;type_id&quot;: 348,   //套餐内套件商品id
      &quot;materiel_name&quot;: &quot;冰盒400ml&quot;,   //套餐内套件商品名
      &quot;type_name&quot;: &quot;400ml&quot;, //套餐内套件商品型号
      &quot;num&quot;: &quot;20.000000&quot;, //套餐中套件商品组成所需数量
      &quot;serial_info&quot;: [
        {
          &quot;serial_id&quot;: 1,   //序列号id
          &quot;serial_no&quot;: &quot;13&quot;, //序列号
          &quot;storage_manage_id&quot;: 1745 //库存id
        }
      ]
    }
  ]
}
</code></pre></blockquote>
<h2 id="-">库存中套餐套件返仓序列号选择列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>库存中套餐套件返仓序列号选择列表</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/product_return_storage_serial_select</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>关键词(支持序列号，商品名，规格名以及商品编号检索)</td>
<td>sting</td>
<td>保温箱</td>
</tr>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>库存id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
<pre><code>{
  &quot;code&quot;: 0,
  &quot;msg&quot;: &quot;success&quot;,
  &quot;data&quot;: [
    {
      &quot;type_id&quot;: 348,   //套餐内套件商品id
      &quot;materiel_name&quot;: &quot;冰盒400ml&quot;,   //套餐内套件商品名
      &quot;type_name&quot;: &quot;400ml&quot;, //套餐内套件商品型号
      &quot;num&quot;: &quot;20.000000&quot;, //套餐中套件商品组成所需数量
      &quot;serial_info&quot;: [
        {
          &quot;serial_id&quot;: 1,   //序列号id
          &quot;serial_no&quot;: &quot;13&quot;, //序列号
          &quot;storage_manage_id&quot;: &quot;13&quot;, //原库存id
        }
      ]
    }
  ]
}
</code></pre></blockquote>
<h2 id="-">还库商品列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>编辑查询</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/product_balance_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>生产订单id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
  &quot;code&quot;: 0,
  &quot;msg&quot;: &quot;success&quot;,
  &quot;data&quot;: [
       {
      &quot;type_id&quot;: 26899,//原料id
      &quot;materiel_name&quot;: &quot;红富士22&quot;,//原料名称
      &quot;type_name&quot;: &quot;HFS-122&quot;,//原料型号
      &quot;is_use_serial&quot;: 0,//是否开启序列号;0:否;1:是;
      &quot;actual_num&quot;: &quot;20.000000&quot;,//最低原料要求数量
      &quot;rest_handle_num&quot;: 30,//剩余可还库数量
      &quot;storage_manage_info&quot;: [
        {
          &quot;serial_id&quot;: 0,//序列号id
          &quot;serial_no&quot;: &quot;&quot;,//序列号
          &quot;storage_manage_id&quot;: 68038,//库存id
          &quot;storage_name&quot;: &quot;仓库2&quot;,//仓库lid
          &quot;storage_address&quot;: &quot;22&quot;,//仓库地址
          &quot;total_storage_num&quot;: &quot;50.000000&quot;,//原料库存总使用数量
          &quot;handle_num&quot;: &quot;0.000000&quot;//原料已还库数量
                        &quot;shelf_name&quot;:&quot;123&quot;,
                        &quot;location_name&quot;:&quot;test&quot;
        }
    }
  ]
}
</code></pre><h1 id="-">商品分类管理</h1>
<h2 id="-">新建</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>新建</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/materiel_class_add</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>物料分类类型(0:一级分类;1:二级分类;)</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>class_name</td>
<td>是</td>
<td>否</td>
<td>物料分类名称</td>
<td>sting</td>
<td>保温箱</td>
</tr>
<tr>
<td>class_no</td>
<td>是</td>
<td>否</td>
<td>物料分类编号(不能低于或超出8位字符长度)</td>
<td>sting</td>
<td>7udIZcaQ</td>
</tr>
<tr>
<td>parent_id</td>
<td>是</td>
<td>否</td>
<td>上级物料分类id(所添加的分类为一级分类时，默认为0)</td>
<td>integer</td>
<td>179</td>
</tr>
<tr>
<td>is_product_class</td>
<td>否</td>
<td>否</td>
<td>是否套件分类(默认为0);0:商品分类;1:套件分类;</td>
<td>integer</td>
<td>179</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 5032 //新增分类id
    }
}
</code></pre></blockquote>
<blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-11-10 10:51`:新增请求参数`is_product_class`
</code></pre><h2 id="-">删除分类(孙武)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>删除分类</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/materiel_class_del</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>物料分类类型(0:一级分类;1:二级分类;)</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>物料分类名称</td>
<td>sting</td>
<td>71</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
<pre><code>1、一级分类下若存在未删除的二级分类，需先删除其所有二级分类后方可操作
2、二级分类下若存在未删除的物料类型，需先删除其所有物料类型后方可操作
</code></pre><p>数据返回</p>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre></blockquote>
<h2 id="-">修改分类(孙武)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>编辑查询</td>
<td>http</td>
<td>post</td>
<td>api/materiel_class_edit</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>物料分类id</td>
<td>integer</td>
<td>179</td>
</tr>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>物料分类类型(0:一级分类;1:二级分类;)</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>class_name</td>
<td>是</td>
<td>否</td>
<td>物料分类名称</td>
<td>sting</td>
<td>保温箱</td>
</tr>
<tr>
<td>class_no</td>
<td>是</td>
<td>否</td>
<td>物料分类编号(不能低于或超出8位字符长度)</td>
<td>sting</td>
<td>7udIZcaQ</td>
</tr>
<tr>
<td>parent_id</td>
<td>是</td>
<td>否</td>
<td>上级物料分类id(所修改的分类为一级分类时，默认为0)</td>
<td>integer</td>
<td>179</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注 <code>修改指定分类时不需要调整是否为套件分类或商品分类</code></p>
</blockquote>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">下拉</h2>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>下拉</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/materiel_class_select</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>is_product_class</td>
<td>是</td>
<td>否</td>
<td>是否为成品库分类;0:否;1:是;</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: [
        {
            &quot;id&quot;: 127,//物料分类一级id
            &quot;class_name&quot;: &quot;防护用品&quot;,//物料分类一级名称
            &quot;class_no&quot;: &quot;edePWhUW&quot;,//一级分类编号
            &quot;class_info&quot;: [
                {
                    &quot;id&quot;: 139,//物料分类二级id
                    &quot;class_name&quot;: &quot;应急服装&quot;//物料分类二级名称
                    &quot;parent_id&quot;: 127,//上一级id
                    &quot;class_no&quot;: &quot;12346579&quot;//二级分类编号
                },
                {
                    &quot;id&quot;: 138,
                    &quot;class_name&quot;: &quot;其他类&quot;
                    &quot;class_no&quot;: &quot;12346579&quot;
                },
                ......
            ]
        },
        {
            &quot;id&quot;: 68,
            &quot;class_name&quot;: &quot;其他分类&quot;,
            &quot;class_info&quot;: []
        },
        ......
    ]
}
</code></pre><h2 id="-sw-">列表(SW)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>列表</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/materiel_class_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>页面大小</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>当前页</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>materiel_class_id</td>
<td>否</td>
<td>是</td>
<td>物料所属二级分类id;默认为0</td>
<td>integer</td>
<td>57</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>是</td>
<td>关键词(支持<code>物料名</code>,<code>物料型号</code>,<code>物料编号</code>,<code>一、二级分类名称</code>)</td>
<td>string</td>
<td>尸体袋</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: [
        {
            &quot;id&quot;: 57,//物料一级分类id
            &quot;class_name&quot;: &quot;动物尸体袋&quot;,//物料一级分类名称
            &quot;class_no&quot;: &quot;&quot;,//一级分类编号
            &quot;is_product_class&quot;: 0,//是否为成品库分类;0:否;1:是;
            &quot;class_info&quot;: [
                {
                    &quot;id&quot;: 109,//物料二级分类id
                    &quot;class_name&quot;: &quot;动物尸体袋&quot;,//物料二级分类名称
                    &quot;parent_id&quot;: 257,//上级分类id
                    &quot;class_no&quot;: &quot;&quot;,//二级分类编号
                    &quot;is_product_class&quot;: 0,//是否为成品库分类;0:否;1:是;
                    &quot;type_info&quot;: [
                        {
                            &quot;id&quot;: 732,//物料类型id
                            &quot;materiel_name&quot;: &quot;尸体袋1.2米印动物尸体袋&quot;,//物料类型名称
                            &quot;type_name&quot;: &quot;1.2米&quot;,//物料型号名称
                            &quot;materiel_img&quot;: null,//物料图
                            &quot;materiel_no&quot;: &quot;&quot;,//物料编号
                            &quot;materiel_class_id&quot;: 109,//物料二级分类id
                            &quot;main_id&quot;: 7,
                            &quot;remark&quot;: null,//备注
                            &quot;delete_flag&quot;: 0,
                            &quot;created_at&quot;: null,
                            &quot;updated_at&quot;: null,
                            &quot;sec_class_name&quot;: &quot;动物尸体袋&quot;,//物料二级分类名称
                            &quot;fir_class_name&quot;: &quot;动物尸体袋&quot;//物料一级分类名称
                        },
                        ......
                    ]
                }
            ]
            ......
        }
        ......
    ]
}
</code></pre><blockquote>
<p>新增内容</p>
</blockquote>
<pre><code>`2022-11-01 15:32`：新增是否产品库分类`is_product_class`字段返回
</code></pre><h2 id="-">物料分类随机编号(孙武)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>编辑查询</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/materiel_class_rand_no</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;class_no&quot;: &quot;JCT6jHL3&quot;//分类编号
    }
}
</code></pre><h2 id="-zlf-">物料分类导入(zlf)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>导入</td>
<td>http</td>
<td>post</td>
<td>/v3.1.1/api/goods_class_import</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>token</td>
<td>是</td>
<td>否</td>
<td>登录验证token  （用header请求，和库存管理导入一样）</td>
<td>string</td>
<td>6588 IgSpgKXHO7DoZZg6uiNfdhfsdfsffasf==</td>
<td></td>
</tr>
<tr>
<td> class_templete</td>
<td>是</td>
<td>否</td>
<td>导入文件名</td>
<td>string</td>
<td>物料分类</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-zlf-">物料分类模板导出(zlf)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>导出</td>
<td>http</td>
<td>post</td>
<td>/v3.1.1/api/class_temp_download</td>
<td>json</td>
</tr>
</tbody>
</table>
<h1 id="-">库存管理</h1>
<h2 id="-">列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>编辑查询</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/storage_manage_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>每页显示条数</td>
<td>string</td>
<td>1895555555</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>页码</td>
<td>string</td>
<td>1</td>
</tr>
<tr>
<td>storage_id</td>
<td>否</td>
<td>否</td>
<td>仓库id</td>
<td>integer</td>
<td>123456</td>
</tr>
<tr>
<td>materiel_class_id</td>
<td>否</td>
<td>是</td>
<td>物料所属二级分类id</td>
<td>integer</td>
<td>107</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>是</td>
<td>关键词(支持<code>物料名</code>,<code>物料型号</code>,<code>物料编号</code>)</td>
<td>string</td>
<td>电子体温计</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,//当前页
        &quot;data&quot;: [
            {
                &quot;id&quot;: 537,//库存id
                &quot;type_id&quot;: 557,//物料id
                &quot;materiel_name&quot;: &quot;丽肤宝透明质酸补水保湿套盒&quot;,//物料名称
                &quot;type_name&quot;: &quot;5件套&quot;,//物料型号
                &quot;materiel_no&quot;: &quot;&quot;,//物料编号
                &quot;materiel_img&quot;: &#39;&#39;,//物料商品图
                &quot;materiel_mean_cost&quot;: &quot;0.00&quot;,//物料成本价
                &quot;storage_id&quot;: 48,//仓库id
                &quot;storage_name&quot;: &quot;B1-9栋&quot;,//所在仓库
                &quot;storage_address&quot;: &quot;B1-9栋&quot;,//所在仓库地址
                &quot;in_storage_num&quot;: 128,//库存数
                &quot;alert_num&quot;: 0,//低库存预警数
                &quot;f_class_id&quot;: 3,//一级分类id
                &quot;f_class_name&quot;: &quot;美妆用品&quot;,//一级分类名称
                &quot;f_class_no&quot;: &quot;&quot;//一级分类编号
                &quot;s_class_id&quot;: 9,//二级分类id
                &quot;s_class_name&quot;: &quot;护肤品套装&quot;,//二级分类名称
                &quot;s_class_no&quot;: &quot;&quot;,//二级分类编号
                &quot;remark&quot;: &quot;&quot;//商品备注
                &quot;shelf_id&quot;: 0,  //货架id
                &quot;location_id&quot;: 0,   //库位id
                &quot;shelf_name&quot;: null, //货架名
                &quot;location_name&quot;: null,  //库位名
                &quot;is_use_serial&quot;: 0,  //是否开启序列号;0:否;1:是;
                &quot;is_product_materiel&quot;: 0,//是否套餐;0:否;1:是;
            },
            ......
        ],
        &quot;total&quot;: &quot;10&quot;,//页面大小
    }
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-09-07 18:36`:新增返回参数`shelf_id`、`location_id`、`shelf_name`、`location_name`、`is_use_serial`
`2022-12-07 18:36`:新增返回参数`is_product_materiel`
</code></pre><h2 id="-">详情</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>详情</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/storage_manage_detail</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>库存id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 537,//库存id
        &quot;type_id&quot;: 557,//物料id
        &quot;materiel_name&quot;: &quot;丽肤宝透明质酸补水保湿套盒&quot;,//物料名称
        &quot;type_name&quot;: &quot;5件套&quot;,//物料型号
        &quot;materiel_no&quot;: &quot;&quot;,//物料编号
        &quot;materiel_img&quot;: &#39;&#39;,//物料商品图
        &quot;materiel_mean_cost&quot;: &quot;0.00&quot;,//物料成本价
        &quot;storage_id&quot;: 48,//仓库id
        &quot;storage_name&quot;: &quot;B1-9栋&quot;,//所在仓库
        &quot;storage_address&quot;: &quot;B1-9栋&quot;,//所在仓库地址
        &quot;in_storage_num&quot;: 128,//库存数
        &quot;alert_num&quot;: 0,//低库存预警数
        &quot;f_class_id&quot;: 3,//一级分类id
        &quot;f_class_name&quot;: &quot;美妆用品&quot;,//一级分类名称
        &quot;f_class_no&quot;: &quot;&quot;//一级分类编号
        &quot;s_class_id&quot;: 9,//二级分类id
        &quot;s_class_name&quot;: &quot;护肤品套装&quot;,//二级分类名称
        &quot;s_class_no&quot;: &quot;&quot;,//二级分类编号
        &quot;remark&quot;: &quot;&quot;//商品备注
        &quot;shelf_id&quot;: 0,  //货架id
        &quot;location_id&quot;: 0,   //库位id
        &quot;shelf_name&quot;: null, //货架名
        &quot;location_name&quot;: null,  //库位名
        &quot;is_use_serial&quot;: 0,  //是否开启序列号;0:否;1:是;
        &quot;is_product_materiel&quot;: 0,//是否套餐;0:否;1:是;
        //套餐内绑定的商品信息，普通商品返回`[]`
        &quot;product_content&quot;: [
            {
                &quot;type_id&quot;: 52293,   //商品id
                &quot;materiel_name&quot;: &quot;水杯&quot;,  //商品名
                &quot;materiel_no&quot;: &quot;VNNvFWUt&quot;,  //商品编号
                &quot;materiel_img&quot;: &quot;&quot;, //商品图
                &quot;type_name&quot;: &quot;水杯&quot;,  //型号名
                &quot;num&quot;: &quot;1.000000&quot;,   //套餐中绑定的商品所需数量
                &quot;is_use_serial&quot;: 1  //是否使用序列号;0:否;1:是;
            },
            ......
        ]
    }
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-12-07 18:36`:新增返回参数`is_product_materiel`
</code></pre><h1 id="vip-">vip配置</h1>
<h2 id="-">编辑</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>编辑</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/vip_setting_edit</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>vip内容标识</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>first_charge_price</td>
<td>是</td>
<td>否</td>
<td>首充金额</td>
<td>numeric</td>
<td>1.11</td>
</tr>
<tr>
<td>open_vip_cost</td>
<td>是</td>
<td>否</td>
<td>开通vip所需金额(默认为0)</td>
<td>numeric</td>
<td>1.11</td>
</tr>
<tr>
<td>is_vip</td>
<td>是</td>
<td>否</td>
<td>是否有特权;0:否;1:是;<code>不可编辑</code></td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>album_amount</td>
<td>是</td>
<td>否</td>
<td>彩页数量(默认为0)</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>album_page_amount</td>
<td>是</td>
<td>否</td>
<td>彩页页数(默认为0)</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>empty_bill_amount</td>
<td>是</td>
<td>否</td>
<td>空白单数(默认为0)</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>special_seal</td>
<td>是</td>
<td>否</td>
<td>专用印章数(默认为0)</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>one_key_album_times</td>
<td>是</td>
<td>否</td>
<td>一键生成画册次数(默认为0)</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>express_check_times</td>
<td>是</td>
<td>否</td>
<td>快递查询次数(默认为0)</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>account_storage</td>
<td>是</td>
<td>否</td>
<td>存储空间(默认为0)</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>clear_watermark_or_not</td>
<td>是</td>
<td>否</td>
<td>去除水印;0:否;1:是;</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>sub_account_number</td>
<td>是</td>
<td>否</td>
<td>可创建子账号数(默认为0)</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &#39;&#39;
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-08-24 10:42`:增加请求参数`first_charge_price`
`2022-08-16 17:15`:增加请求参数`open_vip_cost`
`2022-08-06 09:44`:增加请求参数`is_vip`，编辑时该参数应被禁止修改
`2022-11-02 10:53`:增加请求参数`sub_account_number`
</code></pre><h1 id="-">公共部分</h1>
<h2 id="-">一键清除</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>一键清除</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/one_key_clear</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>clear_storage</td>
<td>是</td>
<td>否</td>
<td>是否清除库存;0:否;1:是;</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>clear_materiel</td>
<td>是</td>
<td>否</td>
<td>是否清除商品;0:否;1:是;</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>clear_class</td>
<td>是</td>
<td>否</td>
<td>是否清除分类否;0:否;1:是;</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>clear_log</td>
<td>否</td>
<td>否</td>
<td>是否清除出入库记录;0:否;1:是;</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>code</td>
<td>是</td>
<td>否</td>
<td>验证码</td>
<td>integer</td>
<td>123456</td>
</tr>
<tr>
<td>mobile</td>
<td>是</td>
<td>否</td>
<td>主账号手机号</td>
<td>integer</td>
<td>17688888888</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><blockquote>
<p>変更内容</p>
<pre><code>`2022-10-31 16:28`：增加请求参数`clear_log`，一键清除所有出入库记录
</code></pre></blockquote>
<h2 id="-">地址识别</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>地址识别</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/read_address</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>content</td>
<td>是</td>
<td>否</td>
<td>地址信息</td>
<td>string</td>
<td>张三。13333333333...。安徽省蚌埠市龙子湖区合肥工投中小企业产业园37栋</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;name&quot;: &quot;张三&quot;,  //姓名
        &quot;mobile&quot;: &quot;13333333333&quot;,   //手机号
        &quot;address&quot;: &quot;安徽省蚌埠市龙子湖区合肥工投中小企业产业园37栋&quot;  //地址
    }
}
</code></pre><h1 id="-">销售单相关修改</h1>
<h2 id="-">列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>列表</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/sell_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>页面大小</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>当前页</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>repeal_status</td>
<td>是</td>
<td>否</td>
<td>撤销状态：0-未撤销 1-已撤销</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>search_type</td>
<td>是</td>
<td>否</td>
<td>搜索类型</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>status</td>
<td>是</td>
<td>否</td>
<td>状态</td>
<td>integer</td>
<td>0</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1, //当前页
        &quot;data&quot;: [
            {
                &quot;id&quot;: 4,    //销售单主键id
                &quot;main_id&quot;: 7,    //
                &quot;user_id&quot;: 7,    //
                &quot;customer_name&quot;: &quot;张三&quot;,    //客户姓名
                &quot;consignee&quot;: &quot;&quot;,    //收货人
                &quot;phone&quot;: &quot;&quot;,    //联系电话
                &quot;address&quot;: &quot;&quot;,    //收货地址
                &quot;proof_image&quot;: null,    //凭证图片(多图逗号分隔)
                &quot;discount&quot;: null,    //折扣 ：百分比
                                &quot;discount&quot;: 80,         //折扣
                &quot;tax_rate&quot;: null,    // 税率 ：百分比
                                &quot;tax_rate&quot;: 10,    //税率
                &quot;final_money&quot;: &quot;4.60&quot;,    //实际应收金额（即折扣或抹零后价格不含运费）
                &quot;money&quot;: &quot;4.60&quot;,    //货款金额（纯商品金额）
                &quot;real_money&quot;: &quot;0.00&quot;,    //实收金额（实际入账）
                &quot;is_zero_suppression&quot;: 0,    //是否抹零：0-否 1-是
                &quot;other_charges&quot;: &quot;0.00&quot;,    //其他费用
                &quot;remark&quot;: null,    //备注
                &quot;out_order_no&quot;: &quot;&quot;,    //外部单号
                &quot;order_no&quot;: &quot;S71648103178833&quot;,    //订单号-内部单号
                &quot;sell_date&quot;: &quot;2021-11-02 13:22:23&quot;,    //销售时间
                &quot;logistics_company&quot;: &quot;&quot;,    //物流公司
                &quot;logistics_order_no&quot;: &quot;&quot;,    //物流单号
                &quot;out_status&quot;: 0,    //出库状态：0-待出库 1-部分出库 2-全部出库
                &quot;pay_status&quot;: 0,    //付款状态：0-待付款 1-部分付款 2-全部付款
                &quot;order_time&quot;: null,    //下单时间
                &quot;deliver_time&quot;: null,    //发货时间
                &quot;deliver_person&quot;: &quot;&quot;,    //发货人
                &quot;deliver_phone&quot;: &quot;&quot;,    //发货人联系方式
                &quot;has_product_order&quot;: 0, //是否已有生产订单;0:否;1:是;
                &quot;deliver_addr&quot;: &quot;&quot;,    //发货地址
                &quot;repeal_status&quot;: 0,    //撤销状态：0-未撤销 1-已撤销
                &quot;deliver_goods_type&quot;: 0,    //发货方式：1-自提 2-代发 3-送货
                &quot;transport_type&quot;: 0,    //运输方式：1-空运 2-海运 3-铁路 4-公路
                &quot;is_draft&quot;: 0,    //是否草稿：1-是 0-否
                &quot;created_at&quot;: &quot;2022-03-24 14:26:18&quot;,
                &quot;updated_at&quot;: &quot;2022-03-24 14:26:18&quot;,
                &quot;username&quot;: &quot;15505523456&quot;,    //操作人账号
                &quot;nickname&quot;: &quot;用户昵称1&quot;,    //操作人昵称
                &quot;product_no&quot;: &quot;&quot;,//销售单关联的生产订单编号
                                //销售单商品信息部分
                &quot;materiel_info&quot;: [
                    {
                        &quot;sell_goods_id&quot;: 13,//销售单内商品id
                        &quot;name&quot;: &quot;艾纯深海盐肌补水泡泡膜&quot;,    //商品名
                        &quot;type_name&quot;: &quot;泡泡&quot;,    //归革命
                        &quot;price&quot;: &quot;2.30&quot;,    //售价
                        &quot;cost_price&quot;: &quot;0.00&quot;,    //商品成本
                        &quot;num&quot;: 2,    //商品数量
                        &quot;materiel_no&quot;: &quot;&quot;,    //商品编号
                        &quot;image&quot;: &quot;&quot;,    //商品图片
                        &quot;warehouse&quot;: &quot;B2-6栋&quot;,    //仓库名称
                        &quot;warehouse_id&quot;: 4,    //
                        &quot;piece&quot;: 0,    //件数
                        &quot;sell_id&quot;: 4.    //销售单主键id
                        &quot;storage_manage_id&quot;: 532,   库存id
                        &quot;in_storage_num&quot;: null //库存数

                         &quot;shelf_id&quot;: 1613,           货架ID
                        &quot;location_id&quot;: 1614,        库位ID
                        &quot;shelf_name&quot;: &quot;测试货架1&quot;,   货架名称
                        &quot;location_name&quot;: &quot;测试库位2&quot; 库位名称
                    }
                ],
                                //销售单套餐信息部分
                &quot;package_info&quot;: [
                    {
                        &quot;sell_package_id&quot;: 4,    //销售单套餐id
                        &quot;package_id&quot;: 52,    //套餐id
                        &quot;package_name&quot;: &quot;老蓝，5L保温箱+温度显示+1蓝冰+6冰袋&quot;,    //套餐名
                        &quot;price&quot;: &quot;2.30&quot;,    //售价
                        &quot;total_cost&quot;: &quot;0.00&quot;,    //套餐总成本
                        &quot;sell_id&quot;: 4,    //销售单id
                        &quot;num&quot;: 2,    //套餐数量
                        &quot;out_num&quot;: 0,    //已出库套餐数量
                                                //销售单套餐内容部分
                        &quot;package_content&quot;: [
                            {
                                &quot;id&quot;: 50,   //销售单内套餐商品id
                                &quot;num&quot;: 1,   //数量
                                &quot;materiel_type_id&quot;: 13315,  //商品id
                                &quot;package_detail_id&quot;: 43,    //
                                &quot;materiel_name&quot;: &quot;电影&quot;,  //商品名
                                &quot;type_name&quot;: &quot;RL&quot;,  //规格名
                                &quot;materiel_no&quot;: &quot;KK3IiInU&quot;,  //商品编号
                                &quot;materiel_img&quot;: &quot;/uploads/2022/06/21/wHiNMOfp3AI2J2NZm2jcaBAn65rBaSskbRgwuH6l.jpg&quot;, //商品图
                                &quot;s_class_name&quot;: &quot;5-2&quot;,  //二级分类名
                                &quot;s_class_no&quot;: &quot;dbl2&quot;,   //二级分类编号
                                &quot;f_class_name&quot;: &quot;5&quot;,    //一级分类名
                                &quot;f_class_no&quot;: &quot;mAyG&quot;,   //二级分类编号
                                &quot;storage_name&quot;: &quot;6&quot;,    //仓库名
                                &quot;in_storage_num&quot;: 10137 //库存数量

                                &quot;shelf_id&quot;: 1613,           货架ID
                                &quot;location_id&quot;: 1614,        库位ID
                                &quot;shelf_name&quot;: &quot;测试货架1&quot;,   货架名称
                                &quot;location_name&quot;: &quot;测试库位2&quot; 库位名称
                            }
                        ]
                    }
                ],
               &quot;driver&quot;:  {
                    &quot;id&quot;: 5,    //司机主键id
                    &quot;plate_number&quot;: &quot;皖A*98098&quot;,    //车牌   
                    &quot;name&quot;: &quot;陈&quot;,                   //司机姓名
                    &quot;phone&quot;: &quot;18966558879&quot;,         //提货司机电话
                    &quot;logistics_company&quot;: &quot;&quot;,        //物流公司
                    &quot;remark&quot;: &quot;&quot;,                   //备注
                    &quot;plate_image&quot;: &quot;k.png&quot;,         //车牌照片
                    &quot;id_card_image&quot;: &quot;ks.png&quot;,      //身份证照片
                    &quot;driving_licence&quot;: &quot;kks.png&quot;,   //驾驶证照片
                    &quot;sell_id&quot;: 8,                   //销售单主键id
                }
            }
        ],
                ......
        &quot;total&quot;: 3 //总条数
    }
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-25 16:40`:增加`shelf_id`,`location_id`,`shelf_name`,`location_name`返回 
`2022-11-23 15:01`:增加`has_product_order`返回 
</code></pre></blockquote>
<h2 id="-">已有快递信息的销售单列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>已有快递信息的销售单列表</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/sell_express_info</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>页面大小</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>code</td>
<td>否</td>
<td>否</td>
<td>快递号</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
            {
                &quot;logistics_order_no&quot;: &quot;YT6576474579981&quot;,    //快递号
                &quot;logistics_company&quot;: &quot;&quot;    //快递公司名
            }
        ],
        .......
        &quot;total&quot;: 1
    }
}
</code></pre><h2 id="-">详细</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>销售单详细</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/sell_detail</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>销售单主键id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 4,    //销售单主键id
                &quot;main_id&quot;: 7,    //
                &quot;user_id&quot;: 7,    //
                &quot;customer_name&quot;: &quot;张三&quot;,    //客户姓名
                &quot;consignee&quot;: &quot;&quot;,    //收货人
                &quot;phone&quot;: &quot;&quot;,    //联系电话
                &quot;address&quot;: &quot;&quot;,    //收货地址
                &quot;proof_image&quot;: null,    //凭证图片(多图逗号分隔)
                &quot;discount&quot;: null,    //折扣 ：百分比
                &quot;discount&quot;: 80,         //折扣
                &quot;tax_rate&quot;: null,    // 税率 ：百分比
                &quot;tax_rate&quot;: 10,    //税率
                &quot;final_money&quot;: &quot;4.60&quot;,    //实际应收金额（即折扣或抹零后价格不含运费）
                &quot;money&quot;: &quot;4.60&quot;,    //货款金额（纯商品金额）
                &quot;real_money&quot;: &quot;0.00&quot;,    //实收金额（实际入账）
                &quot;is_zero_suppression&quot;: 0,    //是否抹零：0-否 1-是
                &quot;other_charges&quot;: &quot;0.00&quot;,    //其他费用
                &quot;remark&quot;: null,    //备注
                &quot;total_piece&quot;:0, //总件数
                &quot;out_order_no&quot;: &quot;&quot;,    //外部单号
                &quot;order_no&quot;: &quot;S71648103178833&quot;,    //订单号-内部单号
                &quot;sell_date&quot;: &quot;2021-11-02 13:22:23&quot;,    //销售时间
                &quot;logistics_company&quot;: &quot;&quot;,    //物流公司
                &quot;logistics_order_no&quot;: &quot;&quot;,    //物流单号
                &quot;out_status&quot;: 0,    //出库状态：0-待出库 1-部分出库 2-全部出库
                &quot;pay_status&quot;: 0,    //付款状态：0-待付款 1-部分付款 2-全部付款
                &quot;order_time&quot;: null,    //下单时间
                &quot;deliver_time&quot;: null,    //发货时间
                &quot;deliver_person&quot;: &quot;&quot;,    //发货人
                &quot;deliver_phone&quot;: &quot;&quot;,    //发货人联系方式
                &quot;deliver_addr&quot;: &quot;&quot;,    //发货地址
                &quot;repeal_status&quot;: 0,    //撤销状态：0-未撤销 1-已撤销
                &quot;deliver_goods_type&quot;: 0,    //发货方式：1-自提 2-代发 3-送货
                &quot;transport_type&quot;: 0,    //运输方式：1-空运 2-海运 3-铁路 4-公路
                &quot;is_draft&quot;: 0,    //是否草稿：1-是 0-否
                &quot;created_at&quot;: &quot;2022-03-24 14:26:18&quot;,
                &quot;updated_at&quot;: &quot;2022-03-24 14:26:18&quot;,
                &quot;username&quot;: &quot;15505523456&quot;,    //操作人账号
                &quot;nickname&quot;: &quot;用户昵称1&quot;,    //操作人昵称
                &quot;product_order_id&quot;:0,//生产订单id,为0时表示无生成订单
                &quot;product_no&quot;:&quot;p20230110170935356813607&quot;,
                //销售单商品信息部分
                &quot;materiel_info&quot;: [
                    {
                        &quot;sell_goods_id&quot;: 1, 销售单商品id
                        &quot;name&quot;: &quot;艾纯深海盐肌补水泡泡膜&quot;,    //商品名
                        &quot;type_name&quot;: &quot;泡泡&quot;,    //归革命
                        &quot;price&quot;: &quot;2.30&quot;,    //售价
                        &quot;cost_price&quot;: &quot;0.00&quot;,    //商品成本
                        &quot;num&quot;: 2,    //销售商品数量
                        &quot;out_num&quot;: 2,    //已出库商品数量
                        &quot;materiel_no&quot;: &quot;&quot;,    //商品编号
                        &quot;image&quot;: &quot;&quot;,    //商品图片
                        &quot;warehouse&quot;: &quot;B2-6栋&quot;,    //仓库名称
                        &quot;warehouse_id&quot;: 4,    //仓库id
                        &quot;piece&quot;: 0,    //件数
                        &quot;sell_id&quot;: 4.    //销售单主键id
                        &quot;storage_manage_id&quot;: 532, 库存id
                        &quot;materiel_class_id&quot;: 7,//商品二级分类id
                        &quot;in_storage_num&quot;: null, //库存数
                        &quot;materiel_unit&quot;: &#39;&#39;, //商品单位
                        &quot;is_product_materiel&quot;: null, //是否为套餐;0:否;1:是;
                        &quot;materiel_type_id&quot;: 13154, //商品id
                        &quot;shelf_id&quot;: 1613,           货架ID
                        &quot;location_id&quot;: 1614,        库位ID
                        &quot;shelf_name&quot;: &quot;测试货架1&quot;,   货架名称
                        &quot;location_name&quot;: &quot;测试库位2&quot; 库位名称
                        &quot;return_num&quot;: 1,//可退货数量 
                        &quot;is_product_materiel&quot;:1//是否为套餐;0:否;1:是;
                        &quot;content&quot;: [//组件数据
                            {
                                &quot;id&quot;: 10,//组件表id
                                &quot;materiel_name&quot;: &quot;红富士1&quot;,//组件商品名称
                                &quot;type_name&quot;: &quot;HFS-100&quot;,//组件商品型号
                                &quot;materiel_img&quot;: &quot;&quot;,//组件商品图片
                                &quot;materiel_no&quot;: &quot;HFS100&quot;,//组件商品编号
                                &quot;product_id&quot;: 35749,//组件套餐的id
                                &quot;num&quot;: &quot;0.000000&quot;,//数量（这个数量是组件设定的数量，没有乘组件套餐数量）
                                &quot;price&quot;: &quot;1.000000&quot;,//单价
                                &quot;total_price&quot;: &quot;2.000000&quot;//总价(单价*数量)
                            },
                            ......
                        ],
                        &quot;goods_batch_info&quot;: [
                            {
                                &quot;id&quot;: 5,    
                                &quot;storage_batch_id&quot;: 45, //库存批次id
                                &quot;batch_no&quot;: &quot;zs202206281059041095&quot;, //商品批次编号
                                &quot;storage_manage_id&quot;: 10053, //库存id
                                &quot;sell_goods_detail_id&quot;: 296,    //销售单内商品主键id(非商品主键id)
                                &quot;sell_id&quot;: 226, //销售单id
                                &quot;main_id&quot;: 4635,    //
                                &quot;num&quot;: 2,   //数量
                                &quot;rest_num&quot;: 0,  //剩余数量
                                &quot;created_at&quot;: &quot;2022-06-27 17:14:30&quot;,
                                &quot;updated_at&quot;: &quot;2022-06-28 20:04:49&quot;
                            }
                        ],
                    }
                ],
                //销售单套餐信息部分
                &quot;package_info&quot;: [
                    {
                        &quot;id&quot;: 4,    //销售单套餐id
                        &quot;sell_package_id&quot;: 1,  //销售单套餐id
                        &quot;package_id&quot;: 52,    //套餐id
                        &quot;package_name&quot;: &quot;老蓝，5L保温箱+温度显示+1蓝冰+6冰袋&quot;,    //套餐名
                        &quot;price&quot;: &quot;2.30&quot;,    //售价
                        &quot;total_cost&quot;: &quot;0.00&quot;,    //套餐总成本
                        &quot;sell_id&quot;: 4,    //销售单id
                        &quot;num&quot;: 2,    //套餐数量
                        &quot;out_num&quot;: 0,    //已出库套餐数量
                        &quot;piece&quot;: 0,    //件数
                        &quot;package_no&quot;: &quot;zs-p202206181848318757&quot;, //套餐编号
                        //销售单套餐内容部分
                        &quot;package_content&quot;: [
                            {
                                &quot;id&quot;: 16,    // 销售单套餐内容id
                                &quot;sell_package_content_id&quot;: 1,  //销售单套餐内容id（
                                &quot;package_detail_id&quot;: 4,    ///销售单套餐id
                                &quot;materiel_name&quot;: &quot;保温箱5L&quot;,    //商品名
                                &quot;materiel_type_id&quot;: 13304,  //商品id
                                &quot;type_name&quot;: &quot;5L&quot;,    //型号
                                &quot;materiel_no&quot;: &quot;&quot;,    //商品编号
                                &quot;materiel_img&quot;: &quot;&quot;,    //商品图
                                &quot;s_class_name&quot;: &quot;保温箱&quot;,    //二级分类名
                                &quot;s_class_no&quot;: &quot;&quot;,    //二级分类编号
                                &quot;f_class_name&quot;: &quot;保温箱类&quot;,    //一级分类名
                                &quot;f_class_no&quot;: &quot;&quot;,    //一级分类编号
                                &quot;storage_name&quot;: &quot;B2-6&quot;,    //仓库地址
                                &quot;in_storage_num&quot;: 0,    //库存数
                                &quot;num&quot;: 0    //套餐内商品数量
                                &quot;total_num&quot;: 10000， //总数(套餐数量 * 套餐内商品数量)

                                &quot;shelf_id&quot;: 1613,           货架ID
                                &quot;location_id&quot;: 1614,        库位ID
                                &quot;shelf_name&quot;: &quot;测试货架1&quot;,   货架名称
                                &quot;location_name&quot;: &quot;测试库位2&quot; 库位名称

                                &quot;package_batch_info&quot;: [
                                    {
                                        &quot;id&quot;: 2,
                                        &quot;sell_package_content_id&quot;: 42,  //销售单套餐内商品id
                                        &quot;storage_manage_id&quot;: 10031, //库存id
                                        &quot;storage_batch_id&quot;: 20, //库存批次id
                                        &quot;sell_id&quot;: 188, //
                                        &quot;main_id&quot;: 4635,    //
                                        &quot;num&quot;: 100, //数量
                                        &quot;rest_num&quot;: 0,  //剩余数量
                                        &quot;batch_no&quot;: &quot;zs202206281059041095&quot;, //商品批次编号
                                        &quot;created_at&quot;: &quot;2022-06-18 16:31:04&quot;,
                                        &quot;updated_at&quot;: &quot;2022-06-23 18:25:50&quot;
                                    }
                                ]
                            }
                        ]
                    }
                ],
               &quot;driver&quot;:  {
                    &quot;id&quot;: 5,    //司机主键id
                    &quot;plate_number&quot;: &quot;皖A*98098&quot;,    //车牌   
                    &quot;name&quot;: &quot;陈&quot;,                   //司机姓名
                    &quot;phone&quot;: &quot;18966558879&quot;,         //提货司机电话
                    &quot;logistics_company&quot;: &quot;&quot;,        //物流公司
                    &quot;remark&quot;: &quot;&quot;,                   //备注
                    &quot;plate_image&quot;: &quot;k.png&quot;,         //车牌照片
                    &quot;id_card_image&quot;: &quot;ks.png&quot;,      //身份证照片
                    &quot;driving_licence&quot;: &quot;kks.png&quot;,   //驾驶证照片
                    &quot;sell_id&quot;: 8,                   //销售单主键id
                }
        }
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-25 16:40`:增加`shelf_id`,`location_id`,`shelf_name`,`location_name`返回 
`2022-11-23 15:01`:增加`has_product_order`返回 
`2022-11-30 16:40`:增加`is_product_materiel`,`content`返回 
`2022-1-18 10:40`:增加`product_no`返回 
</code></pre></blockquote>
<h2 id="-">添加</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>添加销售单</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/sell_add</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>customer_name</td>
<td>是</td>
<td>否</td>
<td>客户姓名</td>
<td>string</td>
<td>杨总</td>
</tr>
<tr>
<td>goods_info</td>
<td>否</td>
<td>否</td>
<td>商品信息</td>
<td>array</td>
<td>[{&quot;materiel_type_id&quot;:35069,&quot;name&quot;:&quot;测试1&quot;,&quot;type_name&quot;:&quot;型号1&quot;,&quot;materiel_no&quot;:&quot;ol1Tpi3Y&quot;,&quot;price&quot;:&quot;10&quot;,&quot;num&quot;:&quot;100&quot;,&quot;image&quot;:&quot;&quot;,&quot;warehouse&quot;:&quot;shop1&quot;,&quot;warehouse_id&quot;:1872,&quot;shelf_id&quot;:1613,&quot;location_id&quot;:1614}]</td>
</tr>
<tr>
<td>package_info</td>
<td>否</td>
<td>否</td>
<td>套餐信息</td>
<td>array</td>
<td>[{&quot;price&quot;:&quot;1&quot;,&quot;num&quot;:&quot;2&quot;,&quot;package_id&quot;:511,&quot;name&quot;:&quot;新套餐2&quot;,&quot;package_content&quot;:[{&quot;allName&quot;:&quot;测试1/型号1(ol1Tpi3Y)&quot;,&quot;id&quot;:362,&quot;materiel_type_id&quot;:35069,&quot;num&quot;:&quot;5&quot;,&quot;materiel_class_id&quot;:10367,&quot;storage_id&quot;:1872,&quot;storage_manage_id&quot;:29,&quot;shelf_id&quot;:1613,&quot;location_id&quot;:1614},{&quot;allName&quot;:&quot;测试2/型号2(00JvmCY9)&quot;,&quot;id&quot;:363,&quot;materiel_type_id&quot;:35070,&quot;num&quot;:&quot;50&quot;,&quot;materiel_class_id&quot;:10367,&quot;storage_id&quot;:1872,&quot;storage_manage_id&quot;:32,&quot;shelf_id&quot;:1613,&quot;location_id&quot;:1614}]}]</td>
</tr>
<tr>
<td>discount</td>
<td>否</td>
<td>否</td>
<td>折扣 ：百分比</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>tax_rate</td>
<td>否</td>
<td>否</td>
<td>税率 ：百分比</td>
<td>integer</td>
<td>13</td>
</tr>
<tr>
<td>is_zero_suppression</td>
<td>是</td>
<td>否</td>
<td>是否抹零：0-否 1-是</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>final_money</td>
<td>否</td>
<td>否</td>
<td>实际应收金额（即折扣或抹零后价格）如果是抹零此参数必传</td>
<td>string</td>
<td>10.99</td>
</tr>
<tr>
<td>deliver_goods_type</td>
<td>否</td>
<td>否</td>
<td>发货方式：1-自提 2-代发 3-送货</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>transport_type</td>
<td>否</td>
<td>否</td>
<td>运输方式：1-空运 2-海运 3-铁路 4-公路</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>consignee</td>
<td>否</td>
<td>否</td>
<td>收货人</td>
<td>string</td>
<td>孙先生</td>
</tr>
<tr>
<td>phone</td>
<td>否</td>
<td>否</td>
<td>联系方式</td>
<td>string</td>
<td>18977687686</td>
</tr>
<tr>
<td>address</td>
<td>否</td>
<td>否</td>
<td>收货地址</td>
<td>string</td>
<td>大学城</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>杨总</td>
</tr>
<tr>
<td>out_order_no</td>
<td>否</td>
<td>否</td>
<td>外部单号</td>
<td>string</td>
<td>jojdojfo903u40jgi</td>
</tr>
<tr>
<td>sell_date</td>
<td>是</td>
<td>否</td>
<td>销售时间</td>
<td>date</td>
<td>2021-11-01 20:20:20</td>
</tr>
<tr>
<td>is_draft</td>
<td>是</td>
<td>否</td>
<td>是否草稿：1-是 0-否</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>proof_image</td>
<td>否</td>
<td>否</td>
<td>凭证图片(多图逗号分隔)</td>
<td>string</td>
<td>./kkkk.png</td>
</tr>
<tr>
<td>real_money</td>
<td>否</td>
<td>否</td>
<td>实收金额（实际入账）</td>
<td>string</td>
<td>10.99</td>
</tr>
<tr>
<td>source</td>
<td>否</td>
<td>否</td>
<td>订单来源</td>
<td>integer</td>
<td>订单来源:0-未知 1-安卓 2-ios 3-pc 4-微信小程序 5-抖音小程序</td>
</tr>
</tbody>
</table>
<blockquote>
<p>goods_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>materiel_type_id</td>
<td>是</td>
<td>否</td>
<td>商品关联id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>name</td>
<td>是</td>
<td>否</td>
<td>商品名称</td>
<td>string</td>
<td>笔记本</td>
</tr>
<tr>
<td>type_name</td>
<td>是</td>
<td>否</td>
<td>规格</td>
<td>string</td>
<td>Mac</td>
</tr>
<tr>
<td>materiel_no</td>
<td>否</td>
<td>否</td>
<td>编号</td>
<td>string</td>
<td>452342345</td>
</tr>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>价格</td>
<td>string</td>
<td>3</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>image</td>
<td>否</td>
<td>否</td>
<td>商品图片</td>
<td>string</td>
<td>kk.png</td>
</tr>
<tr>
<td>warehouse</td>
<td>是</td>
<td>否</td>
<td>仓库名称</td>
<td>string</td>
<td>一仓</td>
</tr>
<tr>
<td>warehouse_id</td>
<td>是</td>
<td>否</td>
<td>仓库主键id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位id</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>package_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>价格</td>
<td>string</td>
<td>3</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>package_id</td>
<td>是</td>
<td>否</td>
<td>套餐id;默认为0，非0时表示该销售单添加的是套餐内容</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>package_content</td>
<td>是</td>
<td>否</td>
<td>仓库主键id</td>
<td>array</td>
<td>套餐内容</td>
</tr>
</tbody>
</table>
<blockquote>
<p>package_content</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>套餐内容id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>materiel_type_id</td>
<td>是</td>
<td>否</td>
<td>商品id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>materiel_class_id</td>
<td>是</td>
<td>否</td>
<td>商品二级分类id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>storage_id</td>
<td>是</td>
<td>否</td>
<td>出库仓库id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>storage_manage_id</td>
<td>是</td>
<td>否</td>
<td>商品库存id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位id</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: 32      销售单主键id
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-25 16:40`:请求参数 增加`shelf_id`,`location_id`
</code></pre></blockquote>
<h2 id="-">编辑</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>编辑销售单</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/sell_edit</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
<pre><code>修改时，套餐的数据中，`materiel_type_id`为必填，默认为0
</code></pre></blockquote>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>销售主键id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>customer_name</td>
<td>否</td>
<td>否</td>
<td>客户姓名</td>
<td>string</td>
<td>杨总</td>
</tr>
<tr>
<td>goods_info</td>
<td>否</td>
<td>否</td>
<td>商品信息</td>
<td>array</td>
<td>[{&quot;materiel_type_id&quot;:35069,&quot;name&quot;:&quot;测试1&quot;,&quot;type_name&quot;:&quot;型号1&quot;,&quot;materiel_no&quot;:&quot;ol1Tpi3Y&quot;,&quot;price&quot;:&quot;10&quot;,&quot;num&quot;:&quot;100&quot;,&quot;image&quot;:&quot;&quot;,&quot;warehouse&quot;:&quot;shop1&quot;,&quot;warehouse_id&quot;:1872,&quot;shelf_id&quot;:1613,&quot;location_id&quot;:1614}]</td>
</tr>
<tr>
<td>package_info</td>
<td>否</td>
<td>否</td>
<td>套餐信息</td>
<td>array</td>
<td>[{&quot;price&quot;:&quot;1&quot;,&quot;num&quot;:&quot;2&quot;,&quot;package_id&quot;:511,&quot;name&quot;:&quot;新套餐2&quot;,&quot;package_content&quot;:[{&quot;allName&quot;:&quot;测试1/型号1(ol1Tpi3Y)&quot;,&quot;id&quot;:362,&quot;materiel_type_id&quot;:35069,&quot;num&quot;:&quot;5&quot;,&quot;materiel_class_id&quot;:10367,&quot;storage_id&quot;:1872,&quot;storage_manage_id&quot;:29,&quot;shelf_id&quot;:1613,&quot;location_id&quot;:1614},{&quot;allName&quot;:&quot;测试2/型号2(00JvmCY9)&quot;,&quot;id&quot;:363,&quot;materiel_type_id&quot;:35070,&quot;num&quot;:&quot;50&quot;,&quot;materiel_class_id&quot;:10367,&quot;storage_id&quot;:1872,&quot;storage_manage_id&quot;:32,&quot;shelf_id&quot;:1613,&quot;location_id&quot;:1614}]}]</td>
</tr>
<tr>
<td>discount</td>
<td>否</td>
<td>否</td>
<td>折扣 ：百分比</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>tax_rate</td>
<td>否</td>
<td>否</td>
<td>税率 ：百分比</td>
<td>integer</td>
<td>13</td>
</tr>
<tr>
<td>is_zero_suppression</td>
<td>是</td>
<td>否</td>
<td>是否抹零：0-否 1-是</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>final_money</td>
<td>否</td>
<td>否</td>
<td>实际应收金额（即折扣或抹零后价格）如果是抹零此参数必传</td>
<td>string</td>
<td>10.99</td>
</tr>
<tr>
<td>deliver_goods_type</td>
<td>否</td>
<td>否</td>
<td>发货方式：1-自提 2-代发 3-送货</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>transport_type</td>
<td>否</td>
<td>否</td>
<td>运输方式：1-空运 2-海运 3-铁路 4-公路</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>consignee</td>
<td>否</td>
<td>否</td>
<td>收货人</td>
<td>string</td>
<td>孙先生</td>
</tr>
<tr>
<td>phone</td>
<td>否</td>
<td>否</td>
<td>联系方式</td>
<td>string</td>
<td>18977687686</td>
</tr>
<tr>
<td>address</td>
<td>否</td>
<td>否</td>
<td>收货地址</td>
<td>string</td>
<td>大学城</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>杨总</td>
</tr>
<tr>
<td>out_order_no</td>
<td>否</td>
<td>否</td>
<td>外部单号</td>
<td>string</td>
<td>jojdojfo903u40jgi</td>
</tr>
<tr>
<td>sell_date</td>
<td>是</td>
<td>否</td>
<td>销售时间</td>
<td>date</td>
<td>2021-11-01 20:20:20</td>
</tr>
<tr>
<td>is_draft</td>
<td>是</td>
<td>否</td>
<td>是否草稿：1-是 0-否</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>proof_image</td>
<td>否</td>
<td>否</td>
<td>凭证图片(多图逗号分隔)</td>
<td>string</td>
<td>./kkkk.png</td>
</tr>
<tr>
<td>real_money</td>
<td>否</td>
<td>否</td>
<td>实收金额（实际入账）</td>
<td>string</td>
<td>22.90</td>
</tr>
<tr>
<td>logistics_company</td>
<td>否</td>
<td>否</td>
<td>物流公司</td>
<td>string</td>
<td>中通</td>
</tr>
<tr>
<td>logistics_order_no</td>
<td>否</td>
<td>否</td>
<td>物流单号</td>
<td>string</td>
<td>asdfadsu493f9f</td>
</tr>
<tr>
<td>order_time</td>
<td>否</td>
<td>否</td>
<td>下单时间</td>
<td>date</td>
<td>2021-11-01 20:20:20</td>
</tr>
<tr>
<td>deliver_time</td>
<td>否</td>
<td>否</td>
<td>发货时间</td>
<td>date</td>
<td>2021-11-01 20:20:20</td>
</tr>
<tr>
<td>deliver_person</td>
<td>否</td>
<td>否</td>
<td>发货人</td>
<td>string</td>
<td>孙总</td>
</tr>
<tr>
<td>deliver_phone</td>
<td>否</td>
<td>否</td>
<td>发货人联系方式</td>
<td>string</td>
<td>14289877837</td>
</tr>
<tr>
<td>deliver_addr</td>
<td>否</td>
<td>否</td>
<td>发货地址</td>
<td>string</td>
<td>东海大道</td>
</tr>
<tr>
<td>source</td>
<td>否</td>
<td>否</td>
<td>订单来源</td>
<td>integer</td>
<td>订单来源:0-未知 1-安卓 2-ios 3-pc 4-微信小程序 5-抖音小程序</td>
</tr>
<tr>
<td>total_piece</td>
<td>否</td>
<td>否</td>
<td>商品总件数</td>
<td>integer</td>
<td>11</td>
</tr>
<tr>
<td>driver</td>
<td>否</td>
<td>否</td>
<td>司机信息</td>
<td>obj</td>
<td>{&quot;plate_number&quot;:&quot;皖*98098&quot;,&quot;name&quot;:&quot;测试&quot;,&quot;phone&quot;:&quot;18966558879&quot;,&quot;logistics_company&quot;:&quot;&quot;,&quot;remark&quot;:&quot;&quot;,&quot;plate_image&quot;:&quot;k.png&quot;,&quot;id_card_image&quot;:&quot;ks.png&quot;,&quot;driving_licence&quot;:&quot;kks.png&quot;}</td>
</tr>
</tbody>
</table>
<blockquote>
<p>goods_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>materiel_type_id</td>
<td>是</td>
<td>否</td>
<td>商品关联id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>name</td>
<td>是</td>
<td>否</td>
<td>商品名称</td>
<td>string</td>
<td>笔记本</td>
</tr>
<tr>
<td>type_name</td>
<td>是</td>
<td>否</td>
<td>规格</td>
<td>string</td>
<td>Mac</td>
</tr>
<tr>
<td>materiel_no</td>
<td>否</td>
<td>否</td>
<td>编号</td>
<td>string</td>
<td>452342345</td>
</tr>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>价格</td>
<td>string</td>
<td>3</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>image</td>
<td>否</td>
<td>否</td>
<td>商品图片</td>
<td>string</td>
<td>kk.png</td>
</tr>
<tr>
<td>warehouse</td>
<td>是</td>
<td>否</td>
<td>仓库名称</td>
<td>string</td>
<td>一仓</td>
</tr>
<tr>
<td>warehouse_id</td>
<td>是</td>
<td>否</td>
<td>仓库主键id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位id</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>package_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>价格</td>
<td>string</td>
<td>3</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>piece</td>
<td>否</td>
<td>否</td>
<td>件数</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>package_id</td>
<td>是</td>
<td>否</td>
<td>套餐id;默认为0，非0时表示该销售单添加的是套餐内容</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>package_content</td>
<td>是</td>
<td>否</td>
<td>仓库主键id</td>
<td>array</td>
<td>套餐内容</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位id</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>package_content</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>套餐内容id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>type_id</td>
<td>是</td>
<td>否</td>
<td>商品id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>materiel_class_id</td>
<td>是</td>
<td>否</td>
<td>商品二级分类id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>storage_id</td>
<td>是</td>
<td>否</td>
<td>出库仓库id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>storage_manage_id</td>
<td>是</td>
<td>否</td>
<td>商品库存id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位id</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
<pre><code>修改套餐至销售单时，`package_id`不能为0，且`package_content`不能为空，`package_content`中`num`可以自由编辑；
修改商品至销售单时，`package_id`必须为0，且`package_content`为0
</code></pre></blockquote>
<blockquote>
<p>变动内容</p>
<pre><code>`2022-08-25 16:40`:请求参数 增加`shelf_id`,`location_id`
</code></pre></blockquote>
<h2 id="-">出库</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>销售单出库</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/sell_out</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>销售单主键id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>status</td>
<td>是</td>
<td>否</td>
<td>出入库状态：0-部分 1-全部</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>goods_info</td>
<td>否（全部是不传）</td>
<td>否</td>
<td>商品信息</td>
<td>array</td>
<td></td>
</tr>
<tr>
<td>package_info</td>
<td>否（全部是不传）</td>
<td>否</td>
<td>套餐信息</td>
<td>array</td>
<td></td>
</tr>
<tr>
<td>in_storage_time</td>
<td>是</td>
<td>否</td>
<td>出库时间</td>
<td>date</td>
<td>2021-09-09 20:20:11</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>备注</td>
</tr>
</tbody>
</table>
<blockquote>
<p>goods_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>materiel_type_id</td>
<td>是</td>
<td>否</td>
<td>商品关联id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>价格</td>
<td>string</td>
<td>3</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>is_use_serial</td>
<td>是</td>
<td>否</td>
<td>是否使用序列号;0:否;1:是;</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>warehouse_id</td>
<td>是</td>
<td>否</td>
<td>仓库主键id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>package_id</td>
<td>是</td>
<td>否</td>
<td>套餐id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>batch_info</td>
<td>是</td>
<td>否</td>
<td>批次信息，默认为空数组</td>
<td>array</td>
<td>1</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>serial_no</td>
<td>是</td>
<td>否</td>
<td>序列号</td>
<td>string</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>package_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>价格</td>
<td>string</td>
<td>3</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>package_id</td>
<td>是</td>
<td>否</td>
<td>套餐id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>package_content</td>
<td>是</td>
<td>否</td>
<td>销售单套餐内商品信息</td>
<td>array</td>
</tr>
</tbody>
</table>
<blockquote>
<p>package_content</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>package_content_id</td>
<td>是</td>
<td>否</td>
<td>销售单套餐内商品id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>销售单套餐内商品id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>batch_info</td>
<td>是</td>
<td>否</td>
<td>批次信息，默认为空数组</td>
<td>array</td>
<td>1</td>
</tr>
<tr>
<td>serial_no</td>
<td>是</td>
<td>否</td>
<td>序列号</td>
<td>string</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>batch_info</code></p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>batch_id</td>
<td>是</td>
<td>否</td>
<td>批次主键id</td>
<td>string</td>
<td>3</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>storage_manage_id</td>
<td>是</td>
<td>否</td>
<td>库存id</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
<pre><code>设置中如果开启使用批次号出库，则`batch_info`为必填项
</code></pre></blockquote>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-09-3 16:40`:请求参数 增加`goods_info`和`package_content` 增加`serial_no` 序列号参数
`2022-08-25 16:40`:请求参数 增加`shelf_id`,`location_id`
</code></pre></blockquote>
<h2 id="-">销售单已出库序列号列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>编辑查询</td>
<td>http</td>
<td>get</td>
<td>v3.1.1/api/sell_serial_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>销售单id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: [
        {
            &quot;type_id&quot;: 51791,   //商品id
            &quot;materiel_name&quot;: &quot;序列号&quot;, //商品名
            &quot;type_name&quot;: &quot;序列号&quot;, //规格名
            &quot;num&quot;: &quot;1.000000&quot;//套餐商品所需数量
            &quot;serial_info&quot;: [
                {
                    &quot;serial_id&quot;: 1, //序列号id
                    &quot;serial_number&quot;: &quot;二&quot;    //序列号
                },
            ]
        }
    ]
}
</code></pre><h1 id="-">导出管理</h1>
<h3 id="-">库存查看报表导出(孙武)</h3>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>编辑查询</td>
<td>http</td>
<td>get</td>
<td>v3.1.1/api/storage_manage_export</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>s_class_id</td>
<td>否</td>
<td>是</td>
<td>物料二级分类id</td>
<td>integer</td>
<td>2</td>
</tr>
<tr>
<td>storage_id</td>
<td>否</td>
<td>是</td>
<td>仓库id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>是</td>
<td>关键词</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<h2 id="-sw-">采购单导出(Sw)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>采购单导出</td>
<td>http</td>
<td>get</td>
<td>v3.1.1/api/materiel_export</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>token</td>
<td>是</td>
<td>否</td>
<td>登录验证token</td>
<td>string</td>
<td>6588 IgSpgKXHO7DoZZg6uiNfdhfsdfsffasf==</td>
</tr>
<tr>
<td>repeal_status</td>
<td>是</td>
<td>否</td>
<td>撤销状态：0-未撤销 1-已撤销</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>关键词</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>search_type</td>
<td>是</td>
<td>否</td>
<td>搜索类型(0-&gt;商品规格名;1-&gt;商品名称;2-&gt;商品编号;3-&gt;内部单号;4-&gt;外部单号;6-&gt;客户名;8-&gt;发货人)</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>status</td>
<td>是</td>
<td>否</td>
<td>订单状态(0:全部;1:新订单;2:已付款(未入库);3:已完结（已付款，已入库）;4:已入货(未付款);)</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>start_time</td>
<td>否</td>
<td>否</td>
<td>下单起始时间</td>
<td>date</td>
<td>2021-11-02 20:20:20</td>
</tr>
<tr>
<td>end_time</td>
<td>否</td>
<td>否</td>
<td>下单截止时间</td>
<td>date</td>
<td>2021-11-02 20:20:20</td>
</tr>
</tbody>
</table>
<h2 id="-sw-">出入库操作记录导出(Sw)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>出入库操作记录导出</td>
<td>http</td>
<td>get</td>
<td>v3.1.1/api/storage_log_export</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>关键词</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>status</td>
<td>是</td>
<td>否</td>
<td>撤销状态(0:未撤销;1:已撤销;)</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>start_time</td>
<td>否</td>
<td>否</td>
<td>下单起始时间</td>
<td>date</td>
<td>2021-11-02</td>
</tr>
<tr>
<td>end_time</td>
<td>否</td>
<td>否</td>
<td>下单截止时间</td>
<td>date</td>
<td>2021-11-02</td>
</tr>
<tr>
<td>materiel_class_id</td>
<td>否</td>
<td>否</td>
<td>二级商品分类</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<h2 id="-zlf-">销售单导出(zlf)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>列表</td>
<td>http</td>
<td>get</td>
<td>v3.1.1/api/sell_export</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>token</td>
<td>是</td>
<td>否</td>
<td>登录验证token</td>
<td>string</td>
<td>6588 IgSpgKXHO7DoZZg6uiNfdhfsdfsffasf==</td>
</tr>
<tr>
<td>repeal_status</td>
<td>是</td>
<td>否</td>
<td>撤销状态：0-未撤销 1-已撤销</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>撤销状态：0-未撤销 1-已撤销</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>search_type</td>
<td>是</td>
<td>否</td>
<td>搜索类型;1-&gt;商品名称;2-&gt;商品编号;3-&gt;搜索内部单号;4-&gt;搜索外部单号;5-&gt;搜索快递单号;6-&gt;搜索客户姓名;7-&gt;搜索司机姓名;8-&gt;搜索发货人姓名;</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>status</td>
<td>是</td>
<td>否</td>
<td>销售单状态：默认为0;0-&gt;全部;1-&gt;新订单;2-&gt;已收款(未出库);3-&gt;已完结(已收款已出库);4-&gt;已出库(未收款),5-&gt;预出库(未付款),6-&gt;预出库(已付款);</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>start_time</td>
<td>否</td>
<td>否</td>
<td>下单起始时间</td>
<td>date</td>
<td>2021-11-02 20:20:20</td>
</tr>
<tr>
<td>end_time</td>
<td>否</td>
<td>否</td>
<td>下单截止时间</td>
<td>date</td>
<td>2021-11-02 20:20:20</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
</blockquote>
<p>检索时，当关键词<code>keyword</code>为空，以<code>status</code>即销售单状态的检索结果为准；
当检索撤销状态为已撤销时，销售单状态<code>status</code>默认为0；
以上情况中<code>search_type</code>不影响搜索的结果，<code>search_type</code>仅在关键词<code>keyword</code>不为空时起作用；
另，当检索已撤销的销售单时，关键词<code>keyword</code>为空；</p>
<h2 id="-zlf-">退货单导出(zlf)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>退货导出</td>
<td>http</td>
<td>get</td>
<td>v3.1.1/api/sales_retrun_export</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>token</td>
<td>是</td>
<td>否</td>
<td>登录验证token</td>
<td>string</td>
<td>6588 IgSpgKXHO7DoZZg6uiNfdhfsdfsffasf==</td>
<td></td>
</tr>
<tr>
<td>search_type</td>
<td>是</td>
<td>否</td>
<td>搜索类型(1-&gt;商品名称;2-&gt;商品编号;3-&gt;内部单号;4-&gt;外部单号;6-&gt;客户名称;8-&gt;收货人)</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>status</td>
<td>是</td>
<td>否</td>
<td>订单状态(0:全部;1:新订单;2:待退款;3:已退款;4:已完结;)</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>start_time</td>
<td>否</td>
<td>否</td>
<td>开始时间</td>
<td>date</td>
<td>2022-04-15 13:15:22</td>
</tr>
<tr>
<td>end_time</td>
<td>否</td>
<td>否</td>
<td>结束时间</td>
<td>date</td>
<td>2022-04-15 13:15:22</td>
</tr>
<tr>
<td>repeal_status</td>
<td>是</td>
<td>否</td>
<td>撤销状态;0:否;1:是;</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>关键词</td>
<td>string</td>
<td>1</td>
</tr>
</tbody>
</table>
<h2 id="-zlf-">商品采购统计报表导出(zlf)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>商品采购导出</td>
<td>http</td>
<td>get</td>
<td>v3.1.1/api/goods_pcrchase_export</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>token</td>
<td>是</td>
<td>否</td>
<td>登录验证token</td>
<td>string</td>
<td>6588 IgSpgKXHO7DoZZg6uiNfdhfsdfsffasf==</td>
<td></td>
</tr>
<tr>
<td>start_time</td>
<td>否</td>
<td>否</td>
<td>开始时间</td>
<td>date</td>
<td>2021-02-11</td>
</tr>
<tr>
<td>end_time</td>
<td>否</td>
<td>否</td>
<td>结束时间</td>
<td>date</td>
<td>12021-02-11</td>
</tr>
</tbody>
</table>
<h2 id="-zlf-">已销售的商品统计导出(zlf)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>销售商品统计导出</td>
<td>http</td>
<td>get</td>
<td>v3.1.1/api/statistics_goods_sold_export</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>token</td>
<td>是</td>
<td>否</td>
<td>登录验证token</td>
<td>string</td>
<td>6588 IgSpgKXHO7DoZZg6uiNfdhfsdfsffasf==</td>
</tr>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>报表类型;0:商品;1:套餐;</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>start_time</td>
<td>否</td>
<td>否</td>
<td>开始时间</td>
<td>date</td>
<td>2021-02-11</td>
</tr>
<tr>
<td>end_time</td>
<td>否</td>
<td>否</td>
<td>结束时间</td>
<td>date</td>
<td>2021-02-11</td>
</tr>
</tbody>
</table>
<h2 id="-zlf-">销售报表导出(zlf)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>销售报表导出</td>
<td>http</td>
<td>get</td>
<td>v3.1.1/api/statement_sell_export</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>token</td>
<td>是</td>
<td>否</td>
<td>登录验证token</td>
<td>string</td>
<td>6588 IgSpgKXHO7DoZZg6uiNfdhfsdfsffasf==</td>
</tr>
<tr>
<td>start_time</td>
<td>否</td>
<td>否</td>
<td>开始时间</td>
<td>date</td>
<td>2021-02-11</td>
</tr>
<tr>
<td>end_time</td>
<td>否</td>
<td>否</td>
<td>结束时间</td>
<td>date</td>
<td>2021-02-11</td>
</tr>
</tbody>
</table>
<h2 id="-zlf-">成本报表导出(zlf)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>成本报表导出</td>
<td>http</td>
<td>get</td>
<td>v3.1.1/api/cost_statement_export</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>token</td>
<td>是</td>
<td>否</td>
<td>登录验证token</td>
<td>string</td>
<td>6588 IgSpgKXHO7DoZZg6uiNfdhfsdfsffasf==</td>
</tr>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>报表类型;0:商品;1:套餐;</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>start_time</td>
<td>否</td>
<td>否</td>
<td>开始时间</td>
<td>date</td>
<td>2021-02-11</td>
</tr>
<tr>
<td>end_time</td>
<td>否</td>
<td>否</td>
<td>结束时间</td>
<td>date</td>
<td>2021-02-11</td>
</tr>
</tbody>
</table>
<h2 id="-zlf-">支出(收入)明细表导出(zlf)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>支出(收入)明细表导出</td>
<td>http</td>
<td>get</td>
<td>v3.1.1/api/income_expenditure_export</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>token</td>
<td>是</td>
<td>否</td>
<td>登录验证token</td>
<td>string</td>
<td>6588 IgSpgKXHO7DoZZg6uiNfdhfsdfsffasf==</td>
</tr>
<tr>
<td>start_time</td>
<td>否</td>
<td>否</td>
<td>开始时间</td>
<td>date</td>
<td>2021-02-11</td>
</tr>
<tr>
<td>end_time</td>
<td>否</td>
<td>否</td>
<td>结束时间</td>
<td>date</td>
<td>12021-02-11</td>
</tr>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>收支类型：0-收入 1-支出</td>
<td>date</td>
<td>0</td>
</tr>
</tbody>
</table>
<h2 id="-zlf-">库存统计表导出(zlf)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>库存统计表导出</td>
<td>http</td>
<td>get</td>
<td>v3.1.1/api/inventory_statistics_export</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>token</td>
<td>是</td>
<td>否</td>
<td>登录验证token</td>
<td>string</td>
<td>6588 IgSpgKXHO7DoZZg6uiNfdhfsdfsffasf==</td>
</tr>
</tbody>
</table>
<h2 id="-zlf-">仓库统计表导出(zlf)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>仓库统计表导出</td>
<td>http</td>
<td>get</td>
<td>v3.1.1/api/statement_storage_export</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>token</td>
<td>是</td>
<td>否</td>
<td>登录验证token</td>
<td>string</td>
<td>6588 IgSpgKXHO7DoZZg6uiNfdhfsdfsffasf==</td>
</tr>
</tbody>
</table>
<h2 id="-zlf-">客户统计表导出(zlf)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>客户统计表导出</td>
<td>http</td>
<td>get</td>
<td>v3.1.1/api/statement_customer_export</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>token</td>
<td>是</td>
<td>否</td>
<td>登录验证token</td>
<td>string</td>
<td>6588 IgSpgKXHO7DoZZg6uiNfdhfsdfsffasf==</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>客户查询</td>
<td>integer</td>
<td>张三</td>
</tr>
</tbody>
</table>
<h2 id="-zlf-">记账单列表导出(zlf)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>记账单列表导导出</td>
<td>http</td>
<td>get</td>
<td>v3.1.1/api/tall_list_export</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>token</td>
<td>是</td>
<td>否</td>
<td>登录验证token</td>
<td>string</td>
<td>6588 IgSpgKXHO7DoZZg6uiNfdhfsdfsffasf==</td>
</tr>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>类型（2 综合、1支出、0收入 ）</td>
<td>integer</td>
<td>2</td>
</tr>
</tbody>
</table>
<h2 id="-zlf-">报损（报溢）记录导出（zlf）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>列表</td>
<td>http</td>
<td>get</td>
<td>v3.1.1/api/overflow_breakage_export</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>token</td>
<td>是</td>
<td>否</td>
<td>登录验证token</td>
<td>string</td>
<td>6588 IgSpgKXHO7DoZZg6uiNfdhfsdfsffasf==</td>
<td></td>
</tr>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>类型：0-报溢 1-报损</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>repeal_status</td>
<td>是</td>
<td>否</td>
<td>撤销状态：0-未撤销 1-已撤销 2-全部</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>status</td>
<td>是</td>
<td>否</td>
<td>审批状态(即入库状态):0-待审批 1-通过 2-拒绝 3-全部</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>关键词(可用于：商品名，型号名，商品编号，套餐名)</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>start_time</td>
<td>否</td>
<td>否</td>
<td>开始时间</td>
<td>date</td>
<td>2022-04-15 13:15:22</td>
</tr>
<tr>
<td>end_time</td>
<td>否</td>
<td>否</td>
<td>结束时间</td>
<td>date</td>
<td>2022-04-15 13:15:22</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
</blockquote>
<pre><code>报溢单无套餐信息
</code></pre><h1 id="-">画册管理</h1>
<h2 id="-zlf-">添加文字画册内容标签（zlf）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>添加画册内容标签</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/hc_add_content_tags</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pa_id</td>
<td>是</td>
<td>否</td>
<td>文字图片画册id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>sort_number</td>
<td>否</td>
<td>否</td>
<td>排序数字</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>content_tags</td>
<td>否</td>
<td>否</td>
<td>标签名称</td>
<td>string</td>
<td>掌上网络</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;添加成功&quot;,
    &quot;data&quot;: {
        &quot;ct_id&quot;: 6 //内容标签id
    }
}
</code></pre><blockquote>
<p>更新内容</p>
</blockquote>
<pre><code>`2022-10-29 10:16`:删除请求字段`is_top`后台默认为0，创建文字画册时，同时生成首页封面标签，已设置置顶！
</code></pre><h2 id="-zlf-">修改文字画册内容标签（zlf）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>修改画册内容标签</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/hc_upd_content_tags</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pa_id</td>
<td>是</td>
<td>否</td>
<td>文字画册id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>ct_id</td>
<td>是</td>
<td>否</td>
<td>内容标签id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>sort_number</td>
<td>否</td>
<td>否</td>
<td>排序数字</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>content_tags</td>
<td>否</td>
<td>否</td>
<td>标签名称</td>
<td>string</td>
<td>掌上网络</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;修改成功&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><pre><code>`2022-10-29 10:16`:删除请求字段`is_top`
</code></pre><h2 id="-zlf-">新建单图/单视频模板（zlf）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>单图/单视频模板</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/hc_add_text_temp</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pa_id</td>
<td>是</td>
<td>否</td>
<td>文字图片画册id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>temp_type</td>
<td>是</td>
<td>否</td>
<td>模板类型：1、单图/单视频  2、多图/多视频 3、背景模板 4、首页封面模板</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>temp_tags_id</td>
<td>是</td>
<td>否</td>
<td>内容标签id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>h5_temp_id</td>
<td>否</td>
<td>否</td>
<td>H5模板id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>temp_title</td>
<td>否</td>
<td>否</td>
<td>模板标题</td>
<td>string</td>
<td>掌上网络</td>
</tr>
<tr>
<td>temp_color</td>
<td>否</td>
<td>否</td>
<td>模板颜色</td>
<td>string</td>
<td>红</td>
</tr>
<tr>
<td>temp_number</td>
<td>否</td>
<td>否</td>
<td>模板序号</td>
<td>string</td>
<td>123456</td>
</tr>
<tr>
<td>temp_content1</td>
<td>否</td>
<td>否</td>
<td>模板内容1</td>
<td>string</td>
<td>掌上网络，网络开发</td>
</tr>
<tr>
<td>temp_content2</td>
<td>否</td>
<td>否</td>
<td>模板内容2</td>
<td>string</td>
<td>掌上网络，网络开发</td>
</tr>
<tr>
<td>temp_img_video_01</td>
<td>否</td>
<td>否</td>
<td>素材图片/视频 1</td>
<td>file[]</td>
<td>素材图片/视频1文件数据包（多文件上传）</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;添加成功&quot;,
    &quot;data&quot;: {
        &quot;t_id&quot;: 1  //返回新添加内容模板id
    }
}
</code></pre><pre><code>`2022-10-31 10:16`:请求字段`temp_tags_id` 改成了必传
</code></pre><h1 id="-">退货管理</h1>
<h2 id="-">销售单生成退货时详细</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>销售单详细</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/sell_detail</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>销售单主键id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 4,    //销售单主键id
                &quot;main_id&quot;: 7,    //
                &quot;user_id&quot;: 7,    //
                &quot;customer_name&quot;: &quot;张三&quot;,    //客户姓名
                &quot;consignee&quot;: &quot;&quot;,    //收货人
                &quot;phone&quot;: &quot;&quot;,    //联系电话
                &quot;address&quot;: &quot;&quot;,    //收货地址
                &quot;proof_image&quot;: null,    //凭证图片(多图逗号分隔)
                &quot;discount&quot;: null,    //折扣 ：百分比
                &quot;discount&quot;: 80,         //折扣
                &quot;tax_rate&quot;: null,    // 税率 ：百分比
                &quot;tax_rate&quot;: 10,    //税率
                &quot;final_money&quot;: &quot;4.60&quot;,    //实际应收金额（即折扣或抹零后价格不含运费）
                &quot;money&quot;: &quot;4.60&quot;,    //货款金额（纯商品金额）
                &quot;real_money&quot;: &quot;0.00&quot;,    //实收金额（实际入账）
                &quot;is_zero_suppression&quot;: 0,    //是否抹零：0-否 1-是
                &quot;other_charges&quot;: &quot;0.00&quot;,    //其他费用
                &quot;remark&quot;: null,    //备注
                &quot;total_piece&quot;:0, //总件数
                &quot;out_order_no&quot;: &quot;&quot;,    //外部单号
                &quot;order_no&quot;: &quot;S71648103178833&quot;,    //订单号-内部单号
                &quot;sell_date&quot;: &quot;2021-11-02 13:22:23&quot;,    //销售时间
                &quot;logistics_company&quot;: &quot;&quot;,    //物流公司
                &quot;logistics_order_no&quot;: &quot;&quot;,    //物流单号
                &quot;out_status&quot;: 0,    //出库状态：0-待出库 1-部分出库 2-全部出库
                &quot;pay_status&quot;: 0,    //付款状态：0-待付款 1-部分付款 2-全部付款
                &quot;order_time&quot;: null,    //下单时间
                &quot;deliver_time&quot;: null,    //发货时间
                &quot;deliver_person&quot;: &quot;&quot;,    //发货人
                &quot;deliver_phone&quot;: &quot;&quot;,    //发货人联系方式
                &quot;deliver_addr&quot;: &quot;&quot;,    //发货地址
                &quot;repeal_status&quot;: 0,    //撤销状态：0-未撤销 1-已撤销
                &quot;deliver_goods_type&quot;: 0,    //发货方式：1-自提 2-代发 3-送货
                &quot;transport_type&quot;: 0,    //运输方式：1-空运 2-海运 3-铁路 4-公路
                &quot;is_draft&quot;: 0,    //是否草稿：1-是 0-否
                &quot;created_at&quot;: &quot;2022-03-24 14:26:18&quot;,
                &quot;updated_at&quot;: &quot;2022-03-24 14:26:18&quot;,
                &quot;username&quot;: &quot;15505523456&quot;,    //操作人账号
                &quot;nickname&quot;: &quot;用户昵称1&quot;,    //操作人昵称

                //销售单商品信息部分
                &quot;materiel_info&quot;: [
                    {
                        &quot;sell_goods_id&quot;: 1, 销售单商品id
                        &quot;name&quot;: &quot;艾纯深海盐肌补水泡泡膜&quot;,    //商品名
                        &quot;type_name&quot;: &quot;泡泡&quot;,    //归革命
                        &quot;price&quot;: &quot;2.30&quot;,    //售价
                        &quot;cost_price&quot;: &quot;0.00&quot;,    //商品成本
                        &quot;num&quot;: 2,    //销售商品数量
                        &quot;out_num&quot;: 2,    //已出库商品数量
                        &quot;materiel_no&quot;: &quot;&quot;,    //商品编号
                        &quot;image&quot;: &quot;&quot;,    //商品图片
                        &quot;warehouse&quot;: &quot;B2-6栋&quot;,    //仓库名称
                        &quot;warehouse_id&quot;: 4,    //仓库id
                        &quot;piece&quot;: 0,    //件数
                        &quot;sell_id&quot;: 4.    //销售单主键id
                        &quot;storage_manage_id&quot;: 532, 库存id
                        &quot;materiel_class_id&quot;: 7,//商品二级分类id
                        &quot;in_storage_num&quot;: null //库存数
                        &quot;is_use_serial&quot;: 0,//是否使用序列号;0:否;1:是;
                        &quot;storage_manage_id&quot;:1,//库存id

                        &quot;shelf_id&quot;: 1613,           货架ID
                        &quot;location_id&quot;: 1614,        库位ID
                        &quot;shelf_name&quot;: &quot;测试货架1&quot;,   货架名称
                        &quot;location_name&quot;: &quot;测试库位2&quot; 库位名称
                        &quot;return_num&quot;: 1,//可退货数量 
                        &quot;is_product_materiel&quot;:1//是否为套餐;0:否;1:是;
                        &quot;content&quot;: [//组件数据
                            {
                                &quot;id&quot;: 10,//组件表id
                                &quot;materiel_name&quot;: &quot;红富士1&quot;,//组件商品名称
                                &quot;type_name&quot;: &quot;HFS-100&quot;,//组件商品型号
                                &quot;materiel_img&quot;: &quot;&quot;,//组件商品图片
                                &quot;materiel_no&quot;: &quot;HFS100&quot;,//组件商品编号
                                &quot;product_id&quot;: 35749,//组件套餐的id
                                &quot;num&quot;: &quot;0.000000&quot;,//数量（这个数量是组件设定的数量，没有乘组件套餐数量）
                                &quot;price&quot;: &quot;1.000000&quot;,//单价
                                &quot;total_price&quot;: &quot;2.000000&quot;//总价(单价*数量)
                            },
                            ......
                        ],
                        &quot;goods_batch_info&quot;: [
                            {
                                &quot;id&quot;: 5,    
                                &quot;storage_batch_id&quot;: 45, //库存批次id
                                &quot;batch_no&quot;: &quot;zs202206281059041095&quot;, //商品批次编号
                                &quot;storage_manage_id&quot;: 10053, //库存id
                                &quot;sell_goods_detail_id&quot;: 296,    //销售单内商品主键id(非商品主键id)
                                &quot;sell_id&quot;: 226, //销售单id
                                &quot;main_id&quot;: 4635,    //
                                &quot;num&quot;: 2,   //数量
                                &quot;rest_num&quot;: 0,  //剩余数量
                                &quot;created_at&quot;: &quot;2022-06-27 17:14:30&quot;,
                                &quot;updated_at&quot;: &quot;2022-06-28 20:04:49&quot;
                            }
                        ],
                    }
                ],
                //销售单套餐信息部分
                &quot;package_info&quot;: [
                    {
                        &quot;id&quot;: 4,    //销售单套餐id
                        &quot;sell_package_id&quot;: 1,  //销售单套餐id
                        &quot;package_id&quot;: 52,    //套餐id
                        &quot;package_name&quot;: &quot;老蓝，5L保温箱+温度显示+1蓝冰+6冰袋&quot;,    //套餐名
                        &quot;price&quot;: &quot;2.30&quot;,    //售价
                        &quot;total_cost&quot;: &quot;0.00&quot;,    //套餐总成本
                        &quot;sell_id&quot;: 4,    //销售单id
                        &quot;num&quot;: 2,    //套餐数量
                        &quot;out_num&quot;: 0,    //已出库套餐数量
                        &quot;piece&quot;: 0,    //件数
                        &quot;package_no&quot;: &quot;zs-p202206181848318757&quot;, //套餐编号
                        //销售单套餐内容部分
                        &quot;package_content&quot;: [
                            {
                                &quot;id&quot;: 16,    // 销售单套餐内容id
                                &quot;sell_package_content_id&quot;: 1,  //销售单套餐内容id（
                                &quot;package_detail_id&quot;: 4,    ///销售单套餐id
                                &quot;materiel_name&quot;: &quot;保温箱5L&quot;,    //商品名
                                &quot;materiel_type_id&quot;: 13304,  //商品id
                                &quot;type_name&quot;: &quot;5L&quot;,    //型号
                                &quot;materiel_no&quot;: &quot;&quot;,    //商品编号
                                &quot;materiel_img&quot;: &quot;&quot;,    //商品图
                                &quot;s_class_name&quot;: &quot;保温箱&quot;,    //二级分类名
                                &quot;s_class_no&quot;: &quot;&quot;,    //二级分类编号
                                &quot;f_class_name&quot;: &quot;保温箱类&quot;,    //一级分类名
                                &quot;f_class_no&quot;: &quot;&quot;,    //一级分类编号
                                &quot;storage_name&quot;: &quot;B2-6&quot;,    //仓库地址
                                &quot;in_storage_num&quot;: 0,    //库存数
                                &quot;num&quot;: 0    //套餐内商品数量
                                &quot;total_num&quot;: 10000， //总数(套餐数量 * 套餐内商品数量)

                                &quot;shelf_id&quot;: 1613,           货架ID
                                &quot;location_id&quot;: 1614,        库位ID
                                &quot;shelf_name&quot;: &quot;测试货架1&quot;,   货架名称
                                &quot;location_name&quot;: &quot;测试库位2&quot; 库位名称

                                &quot;package_batch_info&quot;: [
                                    {
                                        &quot;id&quot;: 2,
                                        &quot;sell_package_content_id&quot;: 42,  //销售单套餐内商品id
                                        &quot;storage_manage_id&quot;: 10031, //库存id
                                        &quot;storage_batch_id&quot;: 20, //库存批次id
                                        &quot;sell_id&quot;: 188, //
                                        &quot;main_id&quot;: 4635,    //
                                        &quot;num&quot;: 100, //数量
                                        &quot;rest_num&quot;: 0,  //剩余数量
                                        &quot;batch_no&quot;: &quot;zs202206281059041095&quot;, //商品批次编号
                                        &quot;created_at&quot;: &quot;2022-06-18 16:31:04&quot;,
                                        &quot;updated_at&quot;: &quot;2022-06-23 18:25:50&quot;
                                    }
                                ]
                            }
                        ]
                    }
                ],
               &quot;driver&quot;:  {
                    &quot;id&quot;: 5,    //司机主键id
                    &quot;plate_number&quot;: &quot;皖A*98098&quot;,    //车牌   
                    &quot;name&quot;: &quot;陈&quot;,                   //司机姓名
                    &quot;phone&quot;: &quot;18966558879&quot;,         //提货司机电话
                    &quot;logistics_company&quot;: &quot;&quot;,        //物流公司
                    &quot;remark&quot;: &quot;&quot;,                   //备注
                    &quot;plate_image&quot;: &quot;k.png&quot;,         //车牌照片
                    &quot;id_card_image&quot;: &quot;ks.png&quot;,      //身份证照片
                    &quot;driving_licence&quot;: &quot;kks.png&quot;,   //驾驶证照片
                    &quot;sell_id&quot;: 8,                   //销售单主键id
                }
        }
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-25 16:40`:增加`shelf_id`,`location_id`,`shelf_name`,`location_name`返回 
`2022-11-30 16:40`:增加`is_product_materiel`,`content`返回 
</code></pre></blockquote>
<h2 id="-">新建退货单</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>新建</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/sales_return_add</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>customer_name</td>
<td>是</td>
<td>否</td>
<td>客户姓名</td>
<td>string</td>
<td>杨总</td>
</tr>
<tr>
<td>goods_info</td>
<td>是</td>
<td>否</td>
<td>商品信息</td>
<td>array</td>
<td>[{&quot;materiel_type_id&quot;:35069,&quot;price&quot;:&quot;10&quot;,&quot;num&quot;:&quot;200&quot;,&quot;warehouse_id&quot;:1872,&quot;shelf_id&quot;:1613,&quot;location_id&quot;:1614}]</td>
</tr>
<tr>
<td>package_info</td>
<td>是</td>
<td>否</td>
<td>商品信息</td>
<td>array</td>
<td>[{&quot;price&quot;:&quot;1&quot;,&quot;num&quot;:&quot;100&quot;,&quot;package_id&quot;:510,&quot;name&quot;:&quot;新套餐1&quot;,&quot;package_content&quot;:[{&quot;allName&quot;:&quot;测试2/型号2(00JvmCY9)&quot;,&quot;id&quot;:359,&quot;type_id&quot;:35070,&quot;num&quot;:&quot;5&quot;,&quot;materiel_class_id&quot;:10367,&quot;storage_id&quot;:1872,&quot;storage_manage_id&quot;:32,&quot;shelf_id&quot;:1613,&quot;location_id&quot;:1614},{&quot;allName&quot;:&quot;测试1/型号1(ol1Tpi3Y)&quot;,&quot;id&quot;:360,&quot;type_id&quot;:35069,&quot;num&quot;:&quot;100&quot;,&quot;materiel_class_id&quot;:10367,&quot;storage_id&quot;:1872,&quot;storage_manage_id&quot;:29,&quot;shelf_id&quot;:1613,&quot;location_id&quot;:1614}]}]</td>
</tr>
<tr>
<td>discount</td>
<td>否</td>
<td>否</td>
<td>折扣 ：百分比</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>tax_rate</td>
<td>否</td>
<td>否</td>
<td>税率 ：百分比</td>
<td>integer</td>
<td>13</td>
</tr>
<tr>
<td>is_zero_suppression</td>
<td>是</td>
<td>否</td>
<td>是否抹零：0-否 1-是</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>final_money</td>
<td>否</td>
<td>否</td>
<td>实际应收金额（即折扣或抹零后价格）如果是抹零此参数必传</td>
<td>string</td>
<td>10.99</td>
</tr>
<tr>
<td>real_money</td>
<td>否</td>
<td>否</td>
<td>实收金额（实际入账）</td>
<td>string</td>
<td>10.99</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>杨总</td>
</tr>
<tr>
<td>out_order_no</td>
<td>否</td>
<td>否</td>
<td>外部单号</td>
<td>string</td>
<td>jojdojfo903u40jgi</td>
</tr>
<tr>
<td>refund_date</td>
<td>是</td>
<td>否</td>
<td>退货时间</td>
<td>date</td>
<td>2021-11-01 20:20:20</td>
</tr>
<tr>
<td>proof_image</td>
<td>否</td>
<td>否</td>
<td>凭证图片(多图逗号分隔)</td>
<td>string</td>
<td>./kkkk.png</td>
</tr>
<tr>
<td>sell_id</td>
<td>否</td>
<td>否</td>
<td>销售id(销售单生成的退货单时，传递！)</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>goods_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>materiel_type_id</td>
<td>是</td>
<td>否</td>
<td>商品关联id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>价格</td>
<td>string</td>
<td>3</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>return_num</td>
<td>是</td>
<td>否</td>
<td>退货数量(销售单生成的退货单时，传递！)</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>warehouse</td>
<td>是</td>
<td>否</td>
<td>仓库名称</td>
<td>string</td>
<td>一仓</td>
</tr>
<tr>
<td>warehouse_id</td>
<td>是</td>
<td>否</td>
<td>仓库主键id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架ID</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位ID</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>package_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>价格</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>package_id</td>
<td>是</td>
<td>否</td>
<td>套餐id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>name</td>
<td>是</td>
<td>否</td>
<td>套餐名称</td>
<td>string</td>
<td>新套餐</td>
</tr>
<tr>
<td>package_content</td>
<td>是</td>
<td>否</td>
<td>套餐名称</td>
<td>array</td>
<td>套餐内容</td>
</tr>
<tr>
<td>allName</td>
<td>是</td>
<td>否</td>
<td>商品全称</td>
<td>string</td>
<td>测试2/型号2(00JvmCY9)</td>
</tr>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>套餐内容ID</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>type_id</td>
<td>是</td>
<td>否</td>
<td>商品ID</td>
<td>integer</td>
<td>1       </td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>materiel_class_id</td>
<td>是</td>
<td>否</td>
<td>商品分类id</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>storage_id</td>
<td>是</td>
<td>否</td>
<td>仓库ID</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>storage_manage_id</td>
<td>是</td>
<td>否</td>
<td>库存ID</td>
<td>integer</td>
<td>32</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架ID</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位ID</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: 32      退货单主键id
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-25 16:40`:请求参数 goods_info 增加`shelf_id`,`location_id`
`2022-11-23 14:10`:请求参数 goods_info 增加`return_num`
`2022-11-23 14:10`:请求参数  增加`sell_id`
</code></pre></blockquote>
<h2 id="-">详细</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>退货单详细</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/sales_return_find（detail_sales_return_find[无token]）</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>退货主键id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 7,                        退货单主键id
        &quot;main_id&quot;: 7,
        &quot;user_id&quot;: 7,
        &quot;customer_name&quot;: &quot;孙子&quot;,        客户姓名
        &quot;proof_image&quot;: &quot;ii.png&quot;,        凭证图片(多图逗号分隔)
        &quot;discount&quot;: 80,                 折扣 ：百分比
        &quot;tax_rate&quot;: 13,                 税率 ：百分比
        &quot;final_money&quot;: &quot;51&quot;,            实际应收金额（即折扣或抹零后价格或改价金额）
        &quot;money&quot;: &quot;55.20&quot;,               货款金额（纯商品金额）
        &quot;real_money&quot;: &quot;10.00&quot;,          实收金额（实际入账）
        &quot;is_zero_suppression&quot;: 0,       是否改价：0-否 1-是
        &quot;remark&quot;: &quot;hhh&quot;,                备注
        &quot;out_order_no&quot;: &quot;fasdfadsggogjhdghpa&quot;,      外部单号
        &quot;order_no&quot;: &quot;ST71635925491557&quot;,             订单号
        &quot;out_status&quot;: 0,                            出库状态：0-待出库 1-部分出库 2-全部出库
        &quot;pay_status&quot;: 0,                            付款状态：0-待付款 1-部分付款 2-全部付款
        &quot;refund_date&quot;: &quot;2021-09-08 00:00:00&quot;,       退货时间
        &quot;repeal_status&quot;: 0,                         撤销状态：0-未撤销 1-已撤销
        &quot;created_at&quot;: &quot;2021-11-03 15:44:51&quot;,
        &quot;updated_at&quot;: &quot;2021-11-03 15:55:34&quot;,
        &quot;return_materiel&quot;: [
            {
                &quot;materiel_type_id&quot;: 1, 商品关联id
                &quot;name&quot;: &quot;测试&quot;,             商品名称
                &quot;type_name&quot;: &quot;规格&quot;,        型号
                &quot;price&quot;: &quot;2.30&quot;,            售价
                &quot;cost_price&quot;: &quot;0.00&quot;,
                &quot;num&quot;: 2,                   商品已退货数量
                &quot;image&quot;: &quot;商品图片地址&quot;,    商品图片
                &quot;warehouse&quot;: &quot;仓库名称&quot;,    仓库名称
                &quot;warehouse_id&quot;: 1,      
                &quot;piece&quot;: 0,                 件数
                &quot;return_id&quot;: 30,            退货单主键id
                &quot;in_storage_num&quot;: 2         在库数量
                &quot;in_num&quot;: 0,                已入库数量
                &quot;is_in&quot;: 0,                 是否入库： 1-是  0-否
                &quot;materiel_no&quot;: &quot;&quot;, 商品编号
                &quot;is_use_serial&quot;: 0,//开启序列号
                &quot;is_product_materiel&quot;: 1,//是否是组件套餐：1是，0否
                serial_number_list&quot;: [//序列号（组件套餐时，无数据）

                ],
                &quot;goods_batch_list&quot;: [//批次号    （组件套餐时，无数据）            

                    ],
                    &quot;content&quot;: [//组件数组（如果是组件套餐时，返回数据）
                    {
                        &quot;id&quot;: 31,//组件表id
                        &quot;type_id&quot;: 51226,//组件商品id
                        &quot;materiel_name&quot;: &quot;HFS100&quot;,//组件名称
                        &quot;type_name&quot;: &quot;12312&quot;,//组件型号
                        &quot;materiel_img&quot;: &quot;&quot;,//组件图片
                        &quot;materiel_no&quot;: &quot;HFS-100&quot;,//组件编号
                        &quot;product_id&quot;: 29054,//组件套餐id
                        &quot;num&quot;: &quot;1.000000&quot;,（这个数量是组件设定的数量，没有乘组件套餐数量）
                        &quot;price&quot;: &quot;1.000000&quot;,//单价
                        &quot;total_price&quot;: &quot;1.000000&quot;,//总价(单价*数量)
                        &quot;serial_number_list&quot;: [],
                        &quot;product_batch_list&quot;: []
                    },
                    ......
                ]

            }
        ],
        &quot;return_package&quot;: [
            {
                &quot;id&quot;: 3,    //退货单套餐id
                &quot;package_id&quot;: 52,   //套餐id
                &quot;price&quot;: &quot;60.00&quot;,   //售价
                &quot;cost_price&quot;: &quot;12.00&quot;,  //成本价(套餐内每个商品成本*各自组成数量)
                &quot;num&quot;: 22,  //套餐数量
                &quot;in_num&quot;: 0,    //已入库数量
                &quot;is_in&quot;: 0, //是否入库： 1-是  0-否
                &quot;main_id&quot;: 7,
                &quot;return_id&quot;: 6, //退货单主键id
                &quot;created_at&quot;: &quot;2022-04-29 16:14:18&quot;,
                &quot;updated_at&quot;: null, //
                &quot;package_name&quot;: &quot;老蓝，5L保温箱+温度显示+1蓝冰+6冰袋&quot;,    //套餐名
                &quot;package_content&quot;: [
                    {
                        &quot;id&quot;: 1,    //销售单套餐内容id
                        &quot;type_id&quot;: 31,  //商品id
                        &quot;storage_id&quot;: 33,   //仓库id
                        &quot;package_content_id&quot;: 128,  //套餐原始内容id
                        &quot;storage_manage_id&quot;: 1843,  //库存id
                        &quot;return_package_id&quot;: 3, //关联退货单套餐id
                        &quot;package_id&quot;: 52,   //原始套餐id
                        &quot;num&quot;: 10,  //组成数量
                        &quot;in_num&quot;: 0,    //已入库数量
                        &quot;main_id&quot;: 7,   
                        &quot;return_id&quot;: 6, //退货单主键id
                        &quot;created_at&quot;: &quot;2022-04-29 16:14:18&quot;,    
                        &quot;updated_at&quot;: null, 
                        &quot;materiel_name&quot;: &quot;保温箱5L&quot;,   //商品名
                        &quot;type_name&quot;: &quot;5L&quot;,  //商品规格名
                        &quot;storage_name&quot;: &quot;B2-6&quot;, //仓库名
                        &quot;storage_address&quot;: &quot;b 2-6&quot;, //仓库地址
                        &quot;in_storage_num&quot;: 10000 //当前库存数量
                        &quot;materiel_no&quot;: &quot;&quot;, 商品编号
                        &quot;materiel_class_id&quot;: 69, 商品二级分类id
                        &quot;class_name&quot;: &quot;保温箱&quot;  商品分类名                        
                        &quot;materiel_img&quot;: &quot;&quot;,//商品图片
                        &quot;selling_price&quot;: &quot;10.000000&quot;,//商品销售价格
                        &quot;shelf_name&quot;: &quot;默认货架&quot;,//货架
                        &quot;location_name&quot;: &quot;默认库位&quot;//库位
                        &quot;is_use_serial&quot;: 0,//开启序列号
                         serial_number_list&quot;: [//序列号
                        &quot;xiaoshou01&quot;,
                        &quot;xiaoshou02&quot;,
                        &quot;xiaoshou03&quot;
                        ],
                        &quot;goods_batch_list&quot;: [//批次号                    
                            &quot;smyc2022082516171255700&quot;,
                            &quot;smyc2022082516193719990&quot;
                            ],
                    }
                ]
            }
        ]
    }
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-25 16:40`:增加`shelf_id`,`location_id`,`shelf_name`,`location_name`,`materiel_img`,`selling_price`返回 
`2022-09-13 10:10`:增加`is_use_serial`,`serial_number_list`,`goods_batch_list`返回 
`2022-12-1 10:10`:增加`is_product_materiel`,`content`返回 
</code></pre></blockquote>
<h2 id="-">退货入库</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>入库</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/sales_return_in</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>退货单主键id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>status</td>
<td>是</td>
<td>否</td>
<td>出入库状态：0-部分 1-全部</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>goods_info</td>
<td>是</td>
<td>否</td>
<td>商品信息</td>
<td>array</td>
<td>[{&quot;materiel_type_id&quot;:35749,&quot;price&quot;:&quot;18&quot;,&quot;num&quot;:1,&quot;remark&quot;:&quot;&quot;,&quot;warehouse_id&quot;:4281,&quot;shelf_id&quot;:3621,&quot;location_id&quot;:3621,&quot;serial_no&quot;:&quot;&quot;}]</td>
</tr>
<tr>
<td>product_info</td>
<td>是</td>
<td>否</td>
<td>套餐信息</td>
<td>array</td>
<td>[{&quot;materiel_type_id&quot;:520,&quot;price&quot;:&quot;10&quot;,&quot;num&quot;:10,&quot;warehouse_id&quot;:1867,&quot;shelf_id&quot;:1597,&quot;location_id&quot;:1597,&quot;product_content&quot;:[{&quot;id&quot;:88,&quot;type_id&quot;:35172,&quot;num&quot;:1,,&quot;serial_info&quot;:[{&quot;serial_id&quot;:365,&quot;storage_manage_id&quot;:46331,&quot;num&quot;:1}]},{&quot;id&quot;:89,&quot;type_id&quot;:35172,&quot;num&quot;:1,&quot;serial_info&quot;:[{&quot;serial_id&quot;:365,&quot;storage_manage_id&quot;:46331,&quot;num&quot;:1}]}],&quot;remark&quot;:&quot;&quot;}]</td>
</tr>
<tr>
<td>package_info</td>
<td>是</td>
<td>否</td>
<td>老套餐信息</td>
<td>array</td>
<td>[{&quot;package_id&quot;:520,&quot;price&quot;:&quot;1&quot;,&quot;num&quot;:10,&quot;package_content&quot;:[{&quot;id&quot;:88,&quot;type_id&quot;:35172,&quot;num&quot;:&quot;100&quot;,&quot;materiel_class_id&quot;:10389,&quot;storage_id&quot;:1867,&quot;storage_manage_id&quot;:136,&quot;serial_no&quot;:&quot;333333333331&quot;,&quot;batch_info&quot;:[{&quot;batch_id&quot;:289,&quot;num&quot;:&quot;1.000000&quot;,&quot;storage_manage_id&quot;:136}]},{&quot;id&quot;:87,&quot;type_id&quot;:35173,&quot;num&quot;:&quot;1.000000&quot;,&quot;materiel_class_id&quot;:10389,&quot;storage_id&quot;:1867,&quot;storage_manage_id&quot;:138,&quot;serial_no&quot;:&quot;222222222221&quot;,&quot;batch_info&quot;:[{&quot;batch_id&quot;:289,&quot;num&quot;:&quot;1.000000&quot;,&quot;storage_manage_id&quot;:136}]}],&quot;remark&quot;:&quot;&quot;}]</td>
</tr>
<tr>
<td>in_storage_time</td>
<td>是</td>
<td>否</td>
<td>入库时间</td>
<td>date</td>
<td>2021-09-09 20:20:11</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>备注</td>
</tr>
</tbody>
</table>
<blockquote>
<p>goods_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>materiel_type_id</td>
<td>是</td>
<td>否</td>
<td>商品关联id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>价格</td>
<td>string</td>
<td>3</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>退货数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>&quot;&quot;</td>
</tr>
<tr>
<td>warehouse_id</td>
<td>是</td>
<td>否</td>
<td>仓库主键id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架ID</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位ID</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>serial_no</td>
<td>是</td>
<td>否</td>
<td>序列号</td>
<td>string</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>product_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>价格</td>
<td>string</td>
<td>3</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>退货数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>materiel_type_id</td>
<td>是</td>
<td>否</td>
<td>套餐ID</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>&quot;&quot;</td>
</tr>
<tr>
<td>warehouse_id</td>
<td>是</td>
<td>否</td>
<td>仓库主键id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架ID</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位ID</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>package_content</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>组件表id</td>
<td>string</td>
<td>3</td>
</tr>
<tr>
<td>type_id</td>
<td>是</td>
<td>否</td>
<td>组件商品id</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>serial_no</td>
<td>是</td>
<td>否</td>
<td>序列号</td>
<td>string</td>
<td>23421,234324</td>
</tr>
</tbody>
</table>
<blockquote>
<p> serial_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>serial_id</td>
<td>是</td>
<td>否</td>
<td>序列号id</td>
<td>integer</td>
<td>211</td>
</tr>
<tr>
<td>storage_manage_id</td>
<td>是</td>
<td>否</td>
<td>integer</td>
<td>序列号对应库存id</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>序列号数量</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
</blockquote>
<pre><code>1、每个商品对应的每个序列号数量应该都是1，加序列号num参数算总数量用的
</code></pre><blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><blockquote>
<p>更新内容</p>
</blockquote>
<pre><code>`2023-1-16 16:16`:增加返回字段`serial_info`
</code></pre><h1 id="-zlf-">盘点（zlf）</h1>
<h2 id="-">指定仓库商品列表（商品选择也用此接口）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>查询信息</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/get_storage_goods_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>每页显示条数</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>storage_id</td>
<td>是</td>
<td>否</td>
<td>仓库id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
            {
                &quot;id&quot;: 135,//库存id
                &quot;type_id&quot;: 35171,//物料id
                &quot;materiel_name&quot;: &quot;aaaaaaa&quot;,//物料商品名称
                &quot;materiel_img&quot;: &quot;/uploads/2022/08/25/407e5ca1bfec3ea89969ad4b212d0b7d.jpeg&quot;,//物料商品图片
                &quot;shelf_name&quot;: &quot;默认货架&quot;,//货架名称
                &quot;location_name&quot;: &quot;默认库位&quot;,//货架仓位
                &quot;type_name&quot;: &quot;aaaaaaa&quot;,//型号
                &quot;materiel_no&quot;: &quot;DUmawUK5&quot;,//编号
                &quot;total_amount&quot;: &quot;933333.332400&quot;//单个总数量
                &quot;is_product_materiel&quot;: 1,是否是组件套餐
                &quot;is_use_serial&quot;:0,是否开启序列号：1是，0否
                &quot;product_content&quot;: [//组件数组(是组件套餐，数据返回)
                    {
                        &quot;id&quot;: 31,//组件表id
                        &quot;materiel_name&quot;: &quot;HFS100&quot;,//组件名称
                        &quot;type_name&quot;: &quot;12312&quot;,//组件型号
                        &quot;materiel_img&quot;: &quot;&quot;,//组件图片
                        &quot;type_id&quot;: 13241,//组件商品id
                        &quot;materiel_no&quot;: &quot;HFS-100&quot;,//组件编号
                        &quot;product_id&quot;: 35171,//组件套餐id
                        &quot;num&quot;: &quot;1.000000&quot;,//组件设置数量（没有参与套餐数量计算）
                        &quot;price&quot;: &quot;1.000000&quot;,//单价
                        &quot;total_price&quot;: &quot;1.000000&quot;//总价(单价*数量)
                    },
                    ......
                ]
            },
            ......
        ],
        ......
        &quot;next_page_url&quot;: null,
        ......
        &quot;total&quot;: 4
    }
}
</code></pre><h2 id="-">添加整仓盘点（适用添加指定仓库中商品）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>添加整仓盘点</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/add_check_storage_data</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>storage_id</td>
<td>是</td>
<td>否</td>
<td>仓库id</td>
<td>integer</td>
<td>100</td>
</tr>
<tr>
<td>sg_type</td>
<td>是</td>
<td>否</td>
<td>盘点类型（1整仓、2商品）</td>
<td>sting</td>
<td>1</td>
</tr>
<tr>
<td>is_cover</td>
<td>否</td>
<td>否</td>
<td>是否覆盖库存（1是）</td>
<td>sting</td>
<td>1</td>
</tr>
<tr>
<td>goods_info</td>
<td>是</td>
<td>否</td>
<td>要盘点的仓库商品数据包</td>
<td>json</td>
<td>[{&quot;storage_manage_id&quot;:138,&quot;type_id&quot;:35173,&quot;yk_flag&quot;:1,&quot;check_num&quot;:1800,&quot;yk_num&quot;:100,&quot;serial_no&quot;:&quot;21341234,214312&quot;},{&quot;storage_manage_id&quot;:136,&quot;type_id&quot;:35172,&quot;yk_flag&quot;:2,&quot;check_num&quot;:60,&quot;yk_num&quot;:20,&quot;serial_no&quot;:&quot;464,354342,2345&quot;}]</td>
</tr>
<tr>
<td>product_info</td>
<td>是</td>
<td>否</td>
<td>要盘点的仓库组件套餐数据包</td>
<td>json</td>
<td>[{&quot;storage_manage_id&quot;:32486,&quot;type_id&quot;:29054,&quot;yk_flag&quot;:1,&quot;check_num&quot;:32012,&quot;yk_num&quot;:0,&quot;product_content&quot;:[{&quot;id&quot;:88,&quot;type_id&quot;:35172,&quot;num&quot;:1,&quot;serial_no&quot;:&quot;&quot;},{&quot;id&quot;:89,&quot;type_id&quot;:35172,&quot;num&quot;:1,&quot;serial_no&quot;:&quot;&quot;}]},{&quot;storage_manage_id&quot;:27906,&quot;type_id&quot;:31306,&quot;yk_flag&quot;:1,&quot;check_num&quot;:31676,&quot;yk_num&quot;:0,&quot;product_content&quot;:[{&quot;id&quot;:88,&quot;type_id&quot;:35172,&quot;num&quot;:1,&quot;serial_no&quot;:&quot;&quot;},{&quot;id&quot;:89,&quot;type_id&quot;:35172,&quot;num&quot;:1,&quot;serial_no&quot;:&quot;&quot;}]}]</td>
</tr>
</tbody>
</table>
<blockquote>
<p>goods_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>storage_manage_id</td>
<td>是</td>
<td>否</td>
<td>库存id</td>
<td>integer</td>
<td>138</td>
</tr>
<tr>
<td>type_id</td>
<td>是</td>
<td>否</td>
<td>物料id</td>
<td>integer</td>
<td>35173</td>
</tr>
<tr>
<td>yk_flag</td>
<td>是</td>
<td>否</td>
<td>盈亏标示：（1盈、2亏）</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>check_num</td>
<td>是</td>
<td>否</td>
<td>盘点数</td>
<td>integer</td>
<td>800</td>
</tr>
<tr>
<td>yk_num</td>
<td>是</td>
<td>否</td>
<td>盈亏数量</td>
<td>integer</td>
<td>100</td>
</tr>
<tr>
<td>serial_no</td>
<td>否</td>
<td>否</td>
<td>序列号</td>
<td>integer</td>
<td>2142,12432,2343</td>
</tr>
</tbody>
</table>
<blockquote>
<p>product_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>storage_manage_id</td>
<td>是</td>
<td>否</td>
<td>库存id</td>
<td>integer</td>
<td>138</td>
</tr>
<tr>
<td>type_id</td>
<td>是</td>
<td>否</td>
<td>物料id</td>
<td>integer</td>
<td>35173</td>
</tr>
<tr>
<td>yk_flag</td>
<td>是</td>
<td>否</td>
<td>盈亏标示：（1盈、2亏）</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>check_num</td>
<td>是</td>
<td>否</td>
<td>盘点数</td>
<td>integer</td>
<td>800</td>
</tr>
<tr>
<td>yk_num</td>
<td>是</td>
<td>否</td>
<td>盈亏数量</td>
<td>integer</td>
<td>100</td>
</tr>
</tbody>
</table>
<blockquote>
<p>product_content</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>组件表id</td>
<td>integer</td>
<td>138</td>
</tr>
<tr>
<td>type_id</td>
<td>是</td>
<td>否</td>
<td>组件商品id</td>
<td>integer</td>
<td>35173</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>serial_no</td>
<td>否</td>
<td>否</td>
<td>序列号</td>
<td>integer</td>
<td>5647,353456,345235</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">指定盈亏查询盘点商品列表(适用盘点详情列表)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>查询信息</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/check_yk_goods_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>每页显示条数</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>yk_flag</td>
<td>否</td>
<td>否</td>
<td>盈亏标示：（1盈列表、2亏列表）注：字段不传，详情列表</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>check_no</td>
<td>是</td>
<td>否</td>
<td>盘点编号</td>
<td>integer</td>
<td>17897689678568</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>关键词（商品名称）</td>
<td>integer</td>
<td>保温箱</td>
</tr>
</tbody>
</table>
<blockquote>
<p>（普通商品）数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
                {
                &quot;type_id&quot;: 35173,//物料id
                &quot;yk_flag&quot;: 1,//盈亏标示：（1盈列表、2亏列表）注：字段不传，详情列表
                &quot;materiel_name&quot;: &quot;二蛋&quot;,//物料商品名称
                &quot;materiel_img&quot;: &quot;/uploads/2022/08/25/2a5072d20ed1660e6dd79dd19e698041.png&quot;,//物料商品图片
                &quot;check_num&quot;: &quot;1700.000000&quot;,//盘点数量
                &quot;yk_num&quot;: &quot;100.000000&quot;,//盈亏数量
                &quot;in_storage_num&quot;: &quot;1800.000000&quot;,//在库数量
                &quot;shelf_name&quot;: null,//货架名称
                &quot;location_name&quot;: null,//货架仓位
                &quot;storage_name&quot;: &quot;1&quot;,//仓库名称
                &quot;type_name&quot;: &quot;a&quot;,//商品类型
                &quot;materiel_no&quot;: &quot;gARaMa6G&quot;//商品编号
                &quot;check_no&quot;: &quot;65881670382496713&quot;,//盘点编号
                &quot;is_use_serial&quot;: 1,//是否开启序列号：1是、0否
                &quot;is_product_materiel&quot;: 0,//是否组件套餐：1是、0否
                &quot;product_content&quot;: [],//组件数组
                &quot;serial_list&quot;: [//序列号数组
                    &quot;676567&quot;,
                    &quot;555555&quot;
                ]            
            },
            ......
        ],
        ......
        &quot;next_page_url&quot;: null,
        ......
        &quot;total&quot;: 4
    }
}
</code></pre><blockquote>
<p>（组件套餐）数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
                {
                &quot;type_id&quot;: 35173,//物料id
                &quot;yk_flag&quot;: 1,//盈亏标示：（1盈列表、2亏列表）注：字段不传，详情列表
                &quot;materiel_name&quot;: &quot;二蛋&quot;,//物料商品名称
                &quot;materiel_img&quot;: &quot;/uploads/2022/08/25/2a5072d20ed1660e6dd79dd19e698041.png&quot;,//物料商品图片
                &quot;check_num&quot;: &quot;1700.000000&quot;,//盘点数量
                &quot;yk_num&quot;: &quot;100.000000&quot;,//盈亏数量
                &quot;in_storage_num&quot;: &quot;1800.000000&quot;,//在库数量
                &quot;shelf_name&quot;: null,//货架名称
                &quot;location_name&quot;: null,//货架仓位
                &quot;storage_name&quot;: &quot;1&quot;,//仓库名称
                &quot;type_name&quot;: &quot;a&quot;,//商品类型
                &quot;materiel_no&quot;: &quot;gARaMa6G&quot;//商品编号
                &quot;check_no&quot;: &quot;65881670382496713&quot;,//盘点编号
                &quot;is_use_serial&quot;: 1,//是否开启序列号：1是、0否
                &quot;is_product_materiel&quot;: 1,//是否组件套餐：1是、0否
                &quot;product_content&quot;: [{//组件数组
                        &quot;id&quot;: 31,//组件表id
                        &quot;materiel_name&quot;: &quot;HFS100&quot;,//组件名称
                        &quot;type_name&quot;: &quot;12312&quot;,//组件类型
                        &quot;materiel_img&quot;: &quot;&quot;,//组件图片
                        &quot;materiel_no&quot;: &quot;HFS-100&quot;,//组件编号
                        &quot;product_id&quot;: 29054,//组件套餐id
                        &quot;num&quot;: &quot;1.000000&quot;,//组件设置数量（没有乘套餐清点数）
                        &quot;price&quot;: &quot;1.000000&quot;,//单价
                        &quot;type_id&quot;: 51226,//组件关联商品id
                        &quot;total_price&quot;: &quot;1.000000&quot;,//总价(单价*数量)
                        &quot;serial_list&quot;: [//序列号数组
                            &quot;45646&quot;,
                            &quot;353425&quot;
                        ]
                    },
                    ......
                ],

            },
            ......
        ],
        ......
        &quot;next_page_url&quot;: null,
        ......
        &quot;total&quot;: 4
    }
}
</code></pre><h1 id="-">系统管理</h1>
<h2 id="-zlf-">系统微信群图片上传(zlf)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>图片上传</td>
<td>http</td>
<td>post</td>
<td>/v3.1.1/api/wx_group_img_upload</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>wxq_img</td>
<td>是</td>
<td>否</td>
<td>微信群图片</td>
<td>file</td>
<td>数据包</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
</blockquote>
<pre><code>只有超级管理员，才可能上传。第二次上传是更新操作。
</code></pre><blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-zlf-">查询系统微信群图片(zlf)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>查询</td>
<td>http</td>
<td>post</td>
<td>/v3.1.1/api/get_group_img_info</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td></td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;path&quot;: &quot;/uploads/xt/wxq/img/2022-11-17/nvEJrN48J9shle6aiiTOWXyHCCWZ53ARogNmiFAf.png&quot;//系统微信群图片路径
    }
}
</code></pre><h2 id="-zlf-">操作日志(zlf)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>操作日志</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/log_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>页面大小</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>当前页</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>(搜索)操作描述</td>
<td>string</td>
<td>添加用户</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
<pre><code>主账号也可查询操作记录
</code></pre></blockquote>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,      当前页
        &quot;data&quot;: [
            {
                &quot;id&quot;: 5,
                &quot;remark&quot;: &quot;test&quot;,   操作描述
                &quot;data&quot;: {       操作内容（参数实时变动）
                    &quot;id&quot;: 5,
                    &quot;remark&quot;: &quot;test&quot;,
                    &quot;data&quot;: &quot;sdggsg&quot;,
                    &quot;ip&quot;: &quot;127.0.0.1&quot;,
                    &quot;created_at&quot;: null,
                    &quot;username&quot;: &quot;13911557144&quot;
                },
                &quot;ip&quot;: &quot;127.0.0.1&quot;,  IP地址
                &quot;created_at&quot;: 2021-10-14 09:59:52,   操作时间
                &quot;username&quot;: &quot;13911557144&quot;    操作人
            }
        ],  
        &quot;per_page&quot;: &quot;3&quot;,    页面大小
    }
}

</code></pre><h1 id="-zlf-">序列号列表（zlf）</h1>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>序列号列表</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/sales_return_serialnumber_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>条数</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>当前页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>materiel_type_id</td>
<td>是</td>
<td>否</td>
<td>商品id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>status</td>
<td>否</td>
<td>否</td>
<td>1未使用，0使用（不传全部返回）</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>storage_manage_id</td>
<td>否</td>
<td>否</td>
<td>库存id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>否</td>
<td>否</td>
<td>组件套餐退货数量</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>关键词查询（序列号）</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>scene</td>
<td>否</td>
<td>否</td>
<td>使用场景;0:无;1:生产订单;</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>product_order_id</td>
<td>否</td>
<td>否</td>
<td>生产订单id(scene为1时必填)</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
</blockquote>
<pre><code>1.num 是有组件的套餐操作数量，针对（套餐里面组件数量计算使用）传后台计算，不传前端计算;
2.storage_manage_id 是组件的套餐时，必传;  
</code></pre><blockquote>
<p>数据返回（普通商品）</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
            {
                &quot;id&quot;: 10050,    //库存id
                &quot;in_storage_num&quot;: 2147483647,   //库存数
                &quot;materiel_type_id&quot;: 13313,  //商品id
                &quot;materiel_name&quot;: &quot;电脑&quot;,  //商品名
                &quot;type_name&quot;: &quot;TL&quot;,  //规格名
                &quot;materiel_no&quot;: &quot;doH7zpRr&quot;,  //商品编号
                &quot;materiel_img&quot;: &quot;/uploads/2022/06/18/B7okLs1pjwg3ObwlgKB0Iy5n9nvopIr49rrGYFjV.jpg&quot;, //商品图
                &quot;storage_id&quot;: 1836, //仓库id
                &quot;storage_name&quot;: &quot;5&quot;,    //仓库名    
                &quot;serial_number_id&quot;: 35,//序列号id
                &quot;serial_no&quot;: &quot;tuihuo0003&quot;//序列号
            }
        ],
        &quot;total&quot;: 8
    }
}
</code></pre><blockquote>
<p>数据返回（有组件的套餐）</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: [
        {
            &quot;id&quot;: 32486, //库存id
            &quot;in_storage_num&quot;: &quot;32008.000000&quot;, //库存数            
            &quot;materiel_type_id&quot;: 29054,//组件套餐id
            &quot;materiel_name&quot;: &quot;测试&quot;,//组件套餐名称
            &quot;type_name&quot;: &quot;111&quot;,//组件套餐名称
            &quot;materiel_no&quot;: &quot;yORdyRC8&quot;,//组件套餐编号
            &quot;materiel_img&quot;: &quot;&quot;,//组件套餐图片
            &quot;storage_id&quot;: 4281,//组件套餐仓库id
            &quot;storage_name&quot;: &quot;龙&quot;,//组件套餐仓库名
            &quot;is_product_materiel&quot;: 1,//是否是组件套餐：0普通商品，1组件套餐            
            &quot;product_content&quot;: [//组件数组
                {
                    &quot;id&quot;: 31,//组件id
                    &quot;num&quot;: 2,//组件数量（如果传了组件套餐操作数量，这个是后端计算好的，如果没传是组件设置的数量）
                    &quot;type_id&quot;: 51226,//组件关联的商品id
                    &quot;product_id&quot;: 29054,//组件套餐id
                    &quot;materiel_name&quot;: &quot;HFS100&quot;,//组件名称
                    &quot;materiel_img&quot;: &quot;/uploads/2022/06/18/B7okLs1pjwg3ObwlgKB0Iy5n9nvopIr49rrGYFjV.jpg&quot;, //商品图
                    &quot;type_name&quot;: &quot;HFS-100&quot;,//规格名
                    &quot;materiel_no&quot;: &quot;HFS100&quot;,//商品编号
                    &quot;is_use_serial&quot;: 1,//开启序列号
                    &quot;product_serial_list&quot;: [
                        {
                            &quot;serial_id&quot;: 452,//序列号id
                            &quot;storage_manage_id&quot;: 46415,//序列号所在的库存id
                            &quot;serial_no&quot;: &quot;7899878&quot;//序列号
                        },
                        ......
                    ]
                },

                ......
            ]
        }
    ]
}
</code></pre><blockquote>
<p>更新内容</p>
</blockquote>
<pre><code>`2022-12-07 15:16`:增加返回字段`type_name`、`materiel_no`、`is_use_serial`、`materiel_img`
`2022-12-07 15:16`:增加返回product_serial_list字段里`serial_id`、`storage_manage_id`、`serial_no`
</code></pre><h1 id="-id-zlf-">通过序列号和商品ID查询仓库商品信息（扫码）(zlf)</h1>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>查询信息</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/get_read_batch_no</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>batch_no</td>
<td>是</td>
<td>否</td>
<td>序列号,商品ID</td>
<td>integer</td>
<td>smyc2022082516171255700</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
</blockquote>
<pre><code>商品ID生成二维码时带前缀（smycg）示例：smycg12345
</code></pre><blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {

        &quot;id&quot;: 135,//库存id
        &quot;type_id&quot;: 35171,//物料id
        &quot;materiel_name&quot;: &quot;aaaaaaa&quot;,//物料商品名称
        &quot;materiel_img&quot;: &quot;/uploads/2022/08/25/407e5ca1bfec3ea89969ad4b212d0b7d.jpeg&quot;,//物料商品图片
        &quot;shelf_name&quot;: &quot;默认货架&quot;,//货架名称
        &quot;location_name&quot;: &quot;默认库位&quot;,//货架仓位
        &quot;type_name&quot;: &quot;aaaaaaa&quot;,//型号
        &quot;materiel_no&quot;: &quot;DUmawUK5&quot;,//编号
        &quot;total_amount&quot;: &quot;933333.332400&quot;,//单个总数量
        &quot;selling_price&quot;: &quot;18.000000&quot;,//销售价格
        &quot;is_use_serial&quot;: 0,//是否开启序列号：1是、0否
        &quot;storage_name&quot;: &quot;龙&quot;,//仓库名称
        &quot;storage_id&quot;: 4281,//仓库id
        &quot;shelf_id&quot;: 3621,//货架id
        &quot;location_id&quot;: 3621,//库位id
        &quot;materiel_class_id&quot;: 19116,//物料所属二级类型
        &quot;materiel_unit&quot;: &quot;&quot;,//商品单位
        &quot;is_album&quot;: 1,//是否在画册中展示;0:否;1:是;
        &quot;is_product_materiel&quot;: 0,//是否为套件;0:否;1:是;
        &quot;length&quot;: &quot;11.000000&quot;,//长(cm)
        &quot;width&quot;: &quot;11.000000&quot;,//宽(cm)
        &quot;height&quot;: &quot;11.000000&quot;,//高(cm)
        &quot;weight&quot;: &quot;11.000000&quot;,//重量(kg)
        &quot;attribute&quot;: &quot;[{\&quot;name\&quot;:\&quot;11\&quot;,\&quot;value\&quot;:\&quot;111\&quot;}]&quot;,//属性
        &quot;cost&quot;: &quot;0.010000&quot;,//成本
        &quot;last_cost&quot;: &quot;0.009901&quot;,//上一次成本(采购撤销回滚cost用)
        &quot;lower_selling_price&quot;: &quot;0.000000&quot;,//最低销售价格
        &quot;remark&quot;: &quot;11&quot;,    //备注
        &quot;product_content&quot;: [//(如果是套件套餐，组件数据返回)
            {
                &quot;id&quot;: 31,//组件表id
                &quot;materiel_name&quot;: &quot;HFS100&quot;,//组件名称
                &quot;type_name&quot;: &quot;12312&quot;,//组件类型
                &quot;materiel_img&quot;: &quot;&quot;,//组件图片
                &quot;materiel_no&quot;: &quot;HFS-100&quot;,//组件编号
                &quot;product_id&quot;: 29054,//组件套餐id
                &quot;num&quot;: &quot;1.000000&quot;,//组件设置数量（没有乘套餐数量）
                &quot;price&quot;: &quot;1.000000&quot;,//单价
                &quot;type_id&quot;: 51226,//组件关联的商品id
                &quot;total_price&quot;: &quot;1.000000&quot;//总价(单价*数量)
            },
            ......
            ]        
    }
}
</code></pre><blockquote>
<p>更新内容</p>
</blockquote>
<pre><code>`2022-09-29 15:16`:增加返回字段`materiel_img、selling_price、is_use_serial、storage_name、storage_id、shelf_id、location_id`
`2022-11-09 15:01`:增加返回字段`materiel_class_id`、`materiel_unit`、`is_album`、`is_product_materiel`、`length`、`width`、`height`、`weight`、`attribute`、
`cost`、`last_cost`、`lower_selling_price`、`remark`
`2022-12-07 15:16`:增加返回字段`product_content`
</code></pre><h1 id="-zlf-">指定仓库商品列表（商品选择也用此接口）(zlf)</h1>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>查询信息</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/get_storage_goods_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>每页显示条数</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>storage_id</td>
<td>是</td>
<td>否</td>
<td>仓库id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>materiel_calss_id</td>
<td>否</td>
<td>否</td>
<td>二级分类id，默认为0</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>关键词</td>
<td>string</td>
<td>面膜</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
            {
                &quot;id&quot;: 135,//库存id
                &quot;type_id&quot;: 35171,//物料id
                &quot;materiel_name&quot;: &quot;aaaaaaa&quot;,//物料商品名称
                &quot;materiel_img&quot;: &quot;/uploads/2022/08/25/407e5ca1bfec3ea89969ad4b212d0b7d.jpeg&quot;,//物料商品图片
                &quot;shelf_name&quot;: &quot;默认货架&quot;,//货架名称
                &quot;location_name&quot;: &quot;默认库位&quot;,//货架仓位
                &quot;type_name&quot;: &quot;aaaaaaa&quot;,//型号
                &quot;materiel_no&quot;: &quot;DUmawUK5&quot;,//编号
                &quot;total_amount&quot;: &quot;933333.332400&quot;//单个总数量
            },
            ......
        ],
        ......
        &quot;next_page_url&quot;: null,
        ......
        &quot;total&quot;: 4
    }
}
</code></pre><pre><code>`2022-11-3 16:36`:请求字段`materiel_calss_id`、`keyword` 
</code></pre><h1 id="-mr-sun-">套餐列表(Mr Sun)</h1>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>编辑查询</td>
<td>http</td>
<td>post</td>
<td>/v3.1.1/api/package_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>每页条数</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>当前页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>是</td>
<td>关键词，支持对<code>分类名、套餐名、物料名称、物料型号和物料以及分类型号</code>检索</td>
<td>string</td>
<td>测试</td>
</tr>
<tr>
<td>storage_id</td>
<td>否</td>
<td>否</td>
<td>仓库id</td>
<td>integer</td>
<td>123456</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
            {
                &quot;id&quot;: 189,
                &quot;package_name&quot;: &quot;黑桃套餐二&quot;,
                &#39;status&#39;: 1, //是否可操作;0:否;1:是;
                &quot;has_many_content&quot;: []
            },
            {
                &quot;id&quot;: 188,//套餐id
                &quot;package_name&quot;: &quot;黑桃套餐一&quot;,//套餐id
                &quot;has_many_content&quot;: [
                    {
                        &quot;id&quot;: 4,//套餐内容id
                        &quot;materiel_first_class_id&quot;: 3,//套餐内物料一级分类id
                        &quot;materiel_first_class_name&quot;: &quot;美妆用品&quot;,//套餐内物料一级分类名
                        &quot;materiel_first_class_no&quot;: &quot;&quot;,//套餐内物料一级分类编号
                        &quot;materiel_class_id&quot;: 7,//套餐内物料二级分类id
                        &quot;materiel_class_name&quot;: &quot;面膜&quot;,//套餐内物料二级分类名
                        &quot;materiel_class_no&quot;: &quot;&quot;,//套餐内物料二级分类编号
                        &quot;materiel_name&quot;: &quot;微精华舒缓修护面膜&quot;,//物料名
                        &quot;type_name&quot;: &quot;修护&quot;,//型号
                        &quot;materiel_img&quot;: &quot;/uploads/2022/08/02/CzpnwutM6Lkb7ezc0q2gHn3rdNyhq301ZJQaSpzk.jpg&quot;,//图片
                        &quot;materiel_thumbnail_img&quot;: &quot;/uploads/2022/08/02/CzpnwutM6Lkb7ezc0q2gHn3rdNyhq301ZJQaSpzk.jpg&quot;,//缩略图片
                        &quot;materiel_no&quot;: &quot;&quot;,//物料编号
                        &quot;storage_id&quot;: 48,//仓库id
                        &quot;storage_name&quot;: &quot;B1-9栋&quot;,//仓库名
                        &quot;storage_address&quot;: &quot;B1-9栋&quot;,//仓库地址
                        &quot;storage_manage_id&quot;: 529,//库存id
                        &quot;package_id&quot;: 188,//套餐id
                        &quot;num&quot;: 101,//套餐内物料数量
                        &#39;in_storage_num&#39;: 110,//库存数
                        &quot;delete_flag&quot;: 0,//是否删除;0:否;1:是;
                        &quot;shelf_id&quot;: 1613, //货架ID
                        &quot;location_id&quot;: 1614,//库位ID
                        &quot;shelf_name&quot;: &quot;测试货架1&quot;, //货架名称
                        &quot;location_name&quot;: &quot;测试库位2&quot; //库位名称
                        &quot;cost&quot;: &quot;12.000001&quot;,//成本
                        &quot;selling_price&quot;: &quot;20.01&quot;//销售价
                    }
                ]
            }
        ],
        &quot;total&quot;: 2 //总条数
    }
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-09-06 16:57`:增加`selling_price`返回
`2022-09-06 14:54`:增加`cost`返回
`2022-09-03 17:14`:增加`materiel_thumbnail_img`返回
`2022-08-29 17:30`:增加`materiel_img`返回
`2022-08-25 16:40`:增加`shelf_id`,`location_id`,`shelf_name`,`location_name`返回 
`2022-11-4 18:02`:增加`storage_id`请求参数
</code></pre></blockquote>
<h1 id="-zlf-">扫码出库(zlf)</h1>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>快速出库</td>
<td>http</td>
<td>post</td>
<td>/v3.1.1/api/fast_out_storage</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>sell_id</td>
<td>否</td>
<td>否</td>
<td>单据id</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>batch_no</td>
<td>是</td>
<td>否</td>
<td>批次号、序列号、商品ID（加前缀smycg）</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>form_type</td>
<td>否</td>
<td>否</td>
<td>单据类型(默认为销售单)0:销售单;</td>
<td>integer</td>
<td>15</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
</blockquote>
<pre><code>商品ID生成二维码时带前缀（smycg）示例：smycg12345
</code></pre><blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h1 id="-sw-">已使用的序列号批量查询(sw)</h1>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>已使用的序列号批量查询</td>
<td>http</td>
<td>post</td>
<td>/v3.1.1/api/used_serial_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>type_id</td>
<td>是</td>
<td>否</td>
<td>商品ID(多商品情况下，id以英文逗号拼接)</td>
<td>string</td>
<td>1,2,3,4</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: [
        {
            &quot;type_id&quot;: 40138,   //商品id
            &quot;materiel_name&quot;: &quot;水果&quot;,  //商品名
            &quot;type_name&quot;: &quot;fhfjjfjf&quot;,    //规格名
            &quot;serial_info&quot;: [
                {
                    &quot;id&quot;: 1,    //序列号id
                    &quot;serial_no&quot;: &quot;1&quot;,   //序列号
                    &quot;type_id&quot;: 40138,   //商品id
                    &quot;storage_manage_id&quot;: 1  //库存id
                },
                ......
            ]
        },
        ......
    [
}
</code></pre><h1 id="-">库存列表</h1>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>编辑查询</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/storage_manage_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>每页显示条数</td>
<td>string</td>
<td>1895555555</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>页码</td>
<td>string</td>
<td>1</td>
</tr>
<tr>
<td>storage_id</td>
<td>否</td>
<td>否</td>
<td>仓库id</td>
<td>integer</td>
<td>123456</td>
</tr>
<tr>
<td>materiel_class_id</td>
<td>否</td>
<td>是</td>
<td>物料所属二级分类id</td>
<td>integer</td>
<td>107</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>是</td>
<td>关键词(支持<code>物料名</code>,<code>物料型号</code>,<code>物料编号</code>)</td>
<td>string</td>
<td>电子体温计</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回(普通商品)</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,//当前页
        &quot;data&quot;: [
            {
                &quot;id&quot;: 537,//库存id
                &quot;type_id&quot;: 557,//物料id
                &quot;materiel_name&quot;: &quot;丽肤宝透明质酸补水保湿套盒&quot;,//物料名称
                &quot;type_name&quot;: &quot;5件套&quot;,//物料型号
                &quot;materiel_no&quot;: &quot;&quot;,//物料编号
                &quot;materiel_img&quot;: &#39;&#39;,//物料商品图
                &quot;materiel_mean_cost&quot;: &quot;0.00&quot;,//物料成本价
                &quot;storage_id&quot;: 48,//仓库id
                &quot;storage_name&quot;: &quot;B1-9栋&quot;,//所在仓库
                &quot;storage_address&quot;: &quot;B1-9栋&quot;,//所在仓库地址
                &quot;in_storage_num&quot;: 128,//库存数
                &quot;alert_num&quot;: 0,//低库存预警数
                &quot;f_class_id&quot;: 3,//一级分类id
                &quot;f_class_name&quot;: &quot;美妆用品&quot;,//一级分类名称
                &quot;f_class_no&quot;: &quot;&quot;//一级分类编号
                &quot;s_class_id&quot;: 9,//二级分类id
                &quot;s_class_name&quot;: &quot;护肤品套装&quot;,//二级分类名称
                &quot;s_class_no&quot;: &quot;&quot;,//二级分类编号
                &quot;remark&quot;: &quot;&quot;//商品备注
                &quot;shelf_id&quot;: 0,  //货架id
                &quot;location_id&quot;: 0,   //库位id
                &quot;shelf_name&quot;: null, //货架名
                &quot;location_name&quot;: null,  //库位名
                &quot;is_use_serial&quot;: 0,  //是否开启序列号;0:否;1:是;
                &quot;is_product_materiel&quot;: 0,//是否套餐;0:否;1:是;
                &quot;product_content&quot;: []
            },
            ......
        ],
        &quot;total&quot;: &quot;10&quot;,//页面大小
    }
}
</code></pre><blockquote>
<p>数据返回(套餐信息)</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,//当前页
        &quot;data&quot;: [
            {
                &quot;id&quot;: 537,//库存id
                &quot;type_id&quot;: 557,//物料id
                &quot;materiel_name&quot;: &quot;丽肤宝透明质酸补水保湿套盒&quot;,//物料名称
                &quot;type_name&quot;: &quot;5件套&quot;,//物料型号
                &quot;materiel_no&quot;: &quot;&quot;,//物料编号
                &quot;materiel_img&quot;: &#39;&#39;,//物料商品图
                &quot;materiel_mean_cost&quot;: &quot;0.00&quot;,//物料成本价
                &quot;storage_id&quot;: 48,//仓库id
                &quot;storage_name&quot;: &quot;B1-9栋&quot;,//所在仓库
                &quot;storage_address&quot;: &quot;B1-9栋&quot;,//所在仓库地址
                &quot;in_storage_num&quot;: 128,//库存数
                &quot;alert_num&quot;: 0,//低库存预警数
                &quot;f_class_id&quot;: 3,//一级分类id
                &quot;f_class_name&quot;: &quot;美妆用品&quot;,//一级分类名称
                &quot;f_class_no&quot;: &quot;&quot;//一级分类编号
                &quot;s_class_id&quot;: 9,//二级分类id
                &quot;s_class_name&quot;: &quot;护肤品套装&quot;,//二级分类名称
                &quot;s_class_no&quot;: &quot;&quot;,//二级分类编号
                &quot;remark&quot;: &quot;&quot;//商品备注
                &quot;shelf_id&quot;: 0,  //货架id
                &quot;location_id&quot;: 0,   //库位id
                &quot;shelf_name&quot;: null, //货架名
                &quot;location_name&quot;: null,  //库位名
                &quot;is_use_serial&quot;: 0,  //是否开启序列号;0:否;1:是;
                &quot;is_product_materiel&quot;: 1,//是否套餐;0:否;1:是;
                &quot;product_content&quot;: [//组件数组(是组件套餐，数据返回)
                    {
                        &quot;id&quot;: 31,//组件表id
                        &quot;materiel_name&quot;: &quot;HFS100&quot;,//组件名称
                        &quot;type_name&quot;: &quot;12312&quot;,//组件型号
                        &quot;materiel_img&quot;: &quot;&quot;,//组件图片
                        &quot;materiel_no&quot;: &quot;HFS-100&quot;,//组件编号
                        &quot;product_id&quot;: 35171,//组件套餐id
                        &quot;num&quot;: &quot;1.000000&quot;,//组件设置数量（没有参与套餐数量计算）
                        &quot;price&quot;: &quot;1.000000&quot;,//单价
                        &quot;total_price&quot;: &quot;1.000000&quot;//总价(单价*数量)
                    },
                    ......
                ]                                
            },
            ......
        ],
        &quot;total&quot;: &quot;10&quot;,//页面大小
    }
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-09-07 18:36`:新增返回参数`shelf_id`、`location_id`、`shelf_name`、`location_name`、`is_use_serial`
`2022-12-07 18:36`:新增返回参数`is_product_materiel`
`2022-1-12 10:36`:新增返回参数`product_content`
</code></pre><h1 id="-zlf-">套件返仓(zlf)</h1>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>套件返仓</td>
<td>http</td>
<td>post</td>
<td>/v3.1.1/api/return_package_store</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>storage_manage_id</td>
<td>是</td>
<td>否</td>
<td>套餐库存id</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>product_id</td>
<td>是</td>
<td>否</td>
<td>套餐id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>product_num</td>
<td>是</td>
<td>否</td>
<td>套餐数量（客户输入的数量）</td>
<td>integer</td>
<td>4</td>
</tr>
<tr>
<td>in_storage_time</td>
<td>是</td>
<td>否</td>
<td>入库时间(如：2008-08-08 08:08:08)</td>
<td>string</td>
<td>2008-08-08 08:08:08</td>
</tr>
<tr>
<td>product_content</td>
<td>是</td>
<td>否</td>
<td>套餐里商品信息</td>
<td>integer</td>
<td>[{&quot;type_id&quot;:51226,&quot;storage_id&quot;:4281,&quot;num&quot;:4,&quot;remark&quot;:&quot;商品&quot;,&quot;serial_info&quot;:[{&quot;serial_id&quot;:365,&quot;storage_manage_id&quot;:46331,&quot;num&quot;:1}]},{&quot;type_id&quot;:51264,&quot;storage_id&quot;:4281,&quot;num&quot;:4,&quot;remark&quot;:&quot;商品&quot;,&quot;serial_info&quot;:[{&quot;serial_id&quot;:366,&quot;storage_manage_id&quot;:32486,&quot;num&quot;:1}]}]</td>
</tr>
</tbody>
</table>
<blockquote>
<p>product_content</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>type_id</td>
<td>是</td>
<td>否</td>
<td>商品id</td>
<td>integer</td>
<td>35173</td>
</tr>
<tr>
<td>storage_id</td>
<td>是</td>
<td>否</td>
<td>仓库id</td>
<td>integer</td>
<td>35173</td>
</tr>
<tr>
<td>shelf_id</td>
<td>否</td>
<td>否</td>
<td>货架id</td>
<td>integer</td>
<td>35173</td>
</tr>
<tr>
<td>location_id</td>
<td>否</td>
<td>否</td>
<td>库位id</td>
<td>integer</td>
<td>35173</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>4</td>
</tr>
<tr>
<td>remark</td>
<td>是</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>手机</td>
</tr>
<tr>
<td>serial_info</td>
<td>是</td>
<td>否</td>
<td>序列号</td>
<td>string</td>
<td>[{&quot;serial_id&quot;:365,&quot;storage_manage_id&quot;:46331,&quot;num&quot;:1}]</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数 <code>serial_info</code></p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>serial_id</td>
<td>是</td>
<td>否</td>
<td>序列号id</td>
<td>integer</td>
<td>211</td>
</tr>
<tr>
<td>storage_manage_id</td>
<td>是</td>
<td>否</td>
<td>integer</td>
<td>序列号对应库存id</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>序列号数量</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
</blockquote>
<pre><code>1、每个商品对应的每个序列号数量应该都是1，加序列号num参数算总数量用的
2、product_content里的num是输入套餐数量product_num*组件商品设置的数量乘积
</code></pre><blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h1 id="-">出入库记录</h1>
<h2 id="-zlf-">出入库列表（zlf）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>操作记录-操作记录列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/storage_log_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>出入库及套餐操作记录</code>公共请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>页面大小</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>当前页</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>操作日志类型;0:入库;1:出库;2:套餐出库;</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>操作记录主键id</td>
<td>string</td>
<td>牛卫士洗衣凝珠</td>
</tr>
<tr>
<td>start_time</td>
<td>否</td>
<td>否</td>
<td>起始时间</td>
<td>date</td>
<td>牛卫士洗衣凝珠</td>
</tr>
<tr>
<td>end_time</td>
<td>否</td>
<td>否</td>
<td>结束时间</td>
<td>date</td>
<td>牛卫士洗衣凝珠</td>
</tr>
<tr>
<td>status</td>
<td>否</td>
<td>否</td>
<td>撤销状态(0:未撤销;1:已撤销;)</td>
<td>integer</td>
<td>牛卫士洗衣凝珠</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>出入库操作记录</code> 独立请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>materiel_class_id</td>
<td>是</td>
<td>否</td>
<td>物料二级分类id，默认为0</td>
<td>integer</td>
<td>0</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>入库操作记录</code>数据返回</p>
</blockquote>
<pre><code>    &quot;data&quot;: {
        ......
        &quot;type&quot;: 0,  //    日志类型;0:入库;1:调拨入库;2:直接入库;3:生产订单入库
        &quot;in_storage_time&quot;: &quot;2021-11-13 13:14:15&quot;,   //入库时间-`入库`时返回
        &quot;purchase_no&quot;: &quot;20211228135710792267486&quot;,    //采购单号
        &quot;last_storage_name&quot;: &quot;&quot;,    //调入前所在仓库名称
        &quot;last_storage_address&quot;: &quot;&quot;,     //调入前所在仓库地址    
         &quot;location_name&quot;: &quot;默认库位&quot;,//库位名称
        &quot;shelf_name&quot;: &quot;默认库位&quot;,//货架名称
        &quot;serial_number&quot;:  [
            &quot;88888&quot;,
            &quot;99999&quot;,
            &quot;1111&quot;
        ]//序列号
        ......
    }
}
</code></pre><blockquote>
<p><code>出库操作记录</code>数据返回</p>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        ......
        &quot;type&quot;: 0,  //type;0:出库;1:调出;2:直接出库;3.生产订单补足或出库
        &quot;out_storage_time&quot;: &quot;2021-11-13 13:14:15&quot;,   //出库时间-`出库`时返回
        &quot;next_storage_name&quot;: &quot;&quot;,    //调入后所在仓库名称    
        &quot;next_storage_address&quot;: &quot;&quot;,     //调入后所在仓库地址    
         &quot;location_name&quot;: &quot;默认库位&quot;,//库位名称
                &quot;shelf_name&quot;: &quot;默认库位&quot;,//货架名称
                &quot;serial_number&quot;:  [
                    &quot;88888&quot;,
                    &quot;99999&quot;,
                    &quot;1111&quot;
                ]//序列号
        ......
    }
}
</code></pre></blockquote>
<blockquote>
<p><code>出入库操作记录</code>公共数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
            {
                &quot;id&quot;: 1,    //日志主键id
                &quot;storage_name&quot;: &quot;蚌埠掌上网络科技有限公司&quot;, //物料当前所在仓库名
                &quot;storage_address&quot;: &quot;B2-6&quot;,  //物料当前所在仓库地址
                &quot;materiel_class_name&quot;: &quot;面膜&quot;,    //物料二级分类名称
                &quot;materiel_class_no&quot;: &quot;&quot;,    //物料二级分类编号
                &quot;materiel_name&quot;: &quot;时尚烟酰胺亮颜保湿面膜&quot;, //物料名称
                &quot;type_name&quot;: &quot;保湿&quot;,  //物料型号
                &quot;materiel_no&quot;: &quot;&quot;,  //物料编号
                &quot;operate_num&quot;: 100, //操作数量
                &quot;last_storage_num&quot;: 0,  //操作前库存数
                &quot;next_storage_num&quot;: 100,    //操作后库存数
                &quot;materiel_mean_cost&quot;: &quot;0.00&quot;,   //物料均价    
                &quot;remark&quot;: &quot;&quot;,   //备注
                &quot;is_cancel&quot;: 0,     //    是否撤销;0:否;1:是;
                &quot;first_class_id&quot;: 3,    //物料一级分类id
                &quot;class_name&quot;: &quot;美妆用品&quot;,   //物料二级分类名称
                &quot;class_no&quot;: &quot;&quot;,  //物料二级分类编号
                &quot;username&quot;: &quot;掌上仓管&quot;,     //操作人账号名
                &quot;nickname&quot;: &quot;施艳梅&quot;,   //操作人昵称
                 &quot;location_name&quot;: &quot;默认库位&quot;,//库位名称
                &quot;shelf_name&quot;: &quot;默认库位&quot;,//货架名称
                &quot;serial_number&quot;:  [
                    &quot;88888&quot;,
                    &quot;99999&quot;,
                    &quot;1111&quot;
                ]//序列号
            },
            ......
        ],
        &quot;total&quot;: 8 //总条数
    }
}
</code></pre><blockquote>
<p><code>套餐出库操作记录</code>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
            {
                &quot;id&quot;: 2,    //套餐出库日志主键id
                &quot;package_name&quot;: &quot;+测试2&quot;, //套餐名
                &quot;num&quot;: 1,   //操作数量
                &quot;remark&quot;: &quot;123123321&quot;,  //备注
                &quot;is_cancel&quot;: 0,//是否撤销;0:否;1:是;
                &quot;created_at&quot;: &quot;2021-12-03 15:28:42&quot;,    //出库时间
                &quot;username&quot;: &quot;掌上仓管&quot;, //操作人账户名
                &quot;nickname&quot;: &quot;施艳梅&quot;   //操作人昵称
                &quot;location_name&quot;: &quot;默认库位&quot;,//库位名称
                &quot;shelf_name&quot;: &quot;默认库位&quot;,//货架名称
                &quot;serial_number&quot;:  [
                    &quot;88888&quot;,
                    &quot;99999&quot;,
                    &quot;1111&quot;
                ]//序列号
            }
        ],
        &quot;total&quot;: 2  //总条目数
    }
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-09-24 10:29`:返回参数 增加`location_name`、`shelf_name`、`serial_number`
</code></pre></blockquote>
<h2 id="-">操作记录详细</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>操作记录-操作记录详细</td>
<td>http</td>
<td>post</td>
<td>api/log_detail</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>操作日志类型;0:入库;1:出库;2:套餐出库;</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>操作日志id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>入库操作记录</code>数据返回</p>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        ......
        &quot;type&quot;: 0,  //操作日志类型;0:入库;1:出库;2:套餐出库;3:生产订单入库
        &quot;last_storage_name&quot;: &quot;&quot;,    //调入前仓库名称-`入库`时返回
        &quot;last_storage_address&quot;: &quot;&quot;, //调入前仓库-`入库`时返回
        &quot;in_storage_time&quot;: &quot;2021-11-13 13:14:15&quot;,   //入库时间-`入库`时返回
        &quot;purchase_no&quot;: &quot;20211228135710792267486&quot;,    //采购单号
        &quot;all_id_type&quot;: 0,   //单据类型;0:无;1:报溢;2:退货;3:采购;4:生产订单;6：组件返仓    
        ......
    }
}
</code></pre><p><code>出库操作记录</code>数据返回</p>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        ......
        &quot;type&quot;: 0,  //type;0:出库;1:调出;2:直接出库;3:生产订单补足或出库    
        &quot;next_storage_name&quot;: &quot;&quot;,    //调出后所在仓库名称-`出库`时返回
        &quot;next_storage_address&quot;: &quot;&quot;, //调出后所在仓库地址-`出库`时返回
         &quot;out_storage_time&quot;: &quot;2021-11-13 13:14:15&quot;,   //出库时间-`出库`时返回
         &quot;all_id_type&quot;: 0,  //单据类型;0:无;1:报损;2:销售;    3:生产订单
        ......
    }
}
</code></pre></blockquote>
<blockquote>
<p><code>出入库操作记录</code>公共数据返回</p>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 1,    //操作日志主键id
        &quot;storage_name&quot;: &quot;蚌埠掌上网络科技有限公司&quot;, //物料当前所在仓库名
        &quot;storage_address&quot;: &quot;B2-6&quot;,  //物料当前所在仓库地址
        &quot;materiel_class_name&quot;: &quot;面膜&quot;,    //物料二级分类名称
        &quot;materiel_class_no&quot;: &quot;&quot;,    //物料二级分类编号
        &quot;materiel_name&quot;: &quot;时尚烟酰胺亮颜保湿面膜&quot;, //物料名称
        &quot;type_name&quot;: &quot;保湿&quot;,  //物料型号
        &quot;materiel_no&quot;: &quot;&quot;,  //物料编号
        &quot;operate_num&quot;: 100, //操作数量
        &quot;last_storage_num&quot;: 0,  //操作前库存数
        &quot;next_storage_num&quot;: 100,    //操作后库存数
        &quot;materiel_mean_cost&quot;: &quot;0.00&quot;,   //物料均价
        &quot;remark&quot;: &quot;&quot;,   //备注
        &quot;is_cancel&quot;: 0, //是否撤销
        &quot;class_name&quot;: &quot;美妆用品&quot;,   //物料一级分类名称
        &quot;class_no&quot;: &quot;&quot;, //物料编号
        &quot;username&quot;: &quot;掌上仓管&quot;, //操作人账号
        &quot;nickname&quot;: &quot;施艳梅&quot;   //操作人昵称
        &quot;order_no&quot;:&quot;S123123sdfasdfa&quot; //订单号
    }
}
</code></pre></blockquote>
<blockquote>
<p><code>套餐出库操作记录</code>数据返回</p>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 4,    //日志主键id
        &quot;package_namenum&quot;: &quot;+测试711111&quot;, //套餐名
        &quot;num&quot;: 1,   //套餐出库操作数量
        &quot;remark&quot;: &quot;&quot;,   //备注
        &quot;created_at&quot;: &quot;2021-12-04 14:05:02&quot;,    //出库时间
        &quot;username&quot;: &quot;掌上仓管&quot;, //操作人用户账号
        &quot;nickname&quot;: &quot;施艳梅&quot;,  //操作人用户昵称
        &quot;content&quot;: [
            {
                &quot;id&quot;: 7,    //套餐内容出库记录主键id
                &quot;log_package_id&quot;: 4,    //父级id
                &quot;storage_name&quot;: &quot;B1-9栋&quot;,    //出库仓库名
                &quot;storage_address&quot;: &quot;B1-9栋&quot;, //出库仓库地址
                &quot;first_class_name&quot;: &quot;美妆用品&quot;, //物料商品一级分类名称
                &quot;second_class_name&quot;: &quot;面膜&quot;,  //物料商品二级分类名称
                &quot;materiel_name&quot;: &quot;时尚烟酰胺亮颜保湿面膜&quot;, //物料名
                &quot;type_name&quot;: &quot;保湿&quot;,  //物料型号
                &quot;operate_num&quot;: 100, //操作数量
                &quot;in_storage_num&quot;: 9900  //当前库存
            }
            ......
        ]
    }
}
</code></pre></blockquote>
<h1 id="-token-">指定物料类型详细信息(无token)</h1>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>编辑查询</td>
<td>http</td>
<td>post</td>
<td>v3.1.1/api/read_goods_id_info</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>goods_id</td>
<td>是</td>
<td>否</td>
<td>物料类型id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 1,//物料类型id
        &quot;materiel_name&quot;: &quot;400ML注水冰盒&quot;,//物料类型名称
        &quot;type_name&quot;: &quot;400ML&quot;,//物料型号
        &quot;materiel_img&quot;: null,//物料图
        &quot;materiel_no&quot;: &quot;&quot;,//物料编号
        &quot;materiel_class_id&quot;: 71,//物料分类二级id
        &quot;remark&quot;: null,//物料备注
        &quot;length&quot;: &quot;0.00&quot;, //长度
        &quot;width&quot;: &quot;0.00&quot;,//宽度
        &quot;height&quot;: &quot;0.00&quot;,//高度
        &quot;weight&quot;: &quot;0.00&quot;,//重量
        &quot;attribute&quot;: &quot;&quot;,//属性
        &quot;cost&quot;: &quot;0.00&quot;,//成本
        &quot;sec_class_name&quot;: &quot;冷源&quot;,//物料二级分类名称
        &quot;fir_class_id&quot;: 56,//物料一级分类id
        &quot;fir_class_name&quot;: &quot;保温箱类&quot;//物料一级分类名称
        &quot;selling_price&quot;:0//销售价格
        &quot;lower_selling_price&quot;:0//最低销售价格
        &quot;is_album&quot;:0,//是否在画册中展示;0:否;1:是;
        &quot;materiel_unit&quot;: &quot;件&quot;,//单位
        &quot;is_use_serial&quot;: 0,//是否开启序列号;0:否;1:是;
    }
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-09-07 15:55`:增加请求参数`is_use_serial`
`2022-08-05 20:13`:增加请求参数`lower_selling_price`,`is_album`,`materiel_unit`,`selling_price`(与接口`materiel_type_edit`增加的请求参数相同)
</code></pre>
          	</article>
        </div>
		</div>
  </body>
</html>
<script type="text/javascript" src="toc/js/jquery-1.4.4.min.js"></script>
<script type="text/javascript" src="toc/js/jquery.ztree.all-3.5.min.js"></script>
<script type="text/javascript" src="toc/js/ztree_toc.js"></script>
<script type="text/javascript" src="toc_conf.js"></script>

<SCRIPT type="text/javascript" >
<!--
$(document).ready(function(){
    var css_conf = eval(markdown_panel_style);
    $('#readme').css(css_conf)
    
    var conf = eval(jquery_ztree_toc_opts);
		$('#tree').ztree_toc(conf);
});
//-->
</SCRIPT>